kernel/eka/include/e32std.h
changeset 291 206a6eaaeb71
parent 177 a232af6b0b1f
equal deleted inserted replaced
289:55a0a1279a7e 291:206a6eaaeb71
  1756 @publishedAll
  1756 @publishedAll
  1757 @released
  1757 @released
  1758 
  1758 
  1759 Stores and manipulates the date and time. 
  1759 Stores and manipulates the date and time. 
  1760 
  1760 
  1761 It represents a date and time as a number of microseconds since midnight, 
  1761 It represents a date and time as a number of microseconds since midnight
  1762 January 1st, 1 AD nominal Gregorian. BC dates are represented by negative 
  1762 at the beginning of 1 January, year 0 (using astronomical numbering, where
  1763 TTime values. A TTime object may be constructed from a TInt64, a TDateTime 
  1763 year 2000 = 2000 AD, year 1600 = 1600 AD, year 1 = 1 AD, and so year 0 =
  1764 a string literal, or by default, which initialises the time to an arbitrary 
  1764 1 BC, year -100 = 101 BC, etc).  The calendar used is nominal Gregorian, so
  1765 value. To access human-readable time information, the TTime may be converted 
  1765 no days are removed from September 1752 or any other month, but leap year
  1766 from a TInt64 into a TDateTime, which represents the date and time as seven 
  1766 calculations before 1600 use the Julian method of every four years, even
  1767 numeric fields and provides functions to extract these fields. Alternatively, 
  1767 for years which are exactly divisible by 100 but not by 400.  Thus leap
  1768 to display the time as text, the time may be formatted and placed into a
  1768 years include: 1200, 1300, 1400, 1500, 1600 and 2000; non-leap years
  1769 descriptor using a variety of formatting commands and which may or may not
  1769 include: 1601, 1700, 1800, 1900 and 2100.
  1770 honour the system's locale settings. The conversion between time and text may
  1770 
  1771 be performed the other way around, so that a descriptor can be parsed and
  1771 A TTime object may be constructed from a TInt64, a TDateTime, a string literal,
  1772 converted into a TTime value.
  1772 or by default, which initialises the time to an arbitrary value. To access
       
  1773 human-readable time information, the TTime may be converted from a TInt64
       
  1774 into a TDateTime, which represents the date and time as seven numeric fields
       
  1775 and provides functions to extract these fields. Alternatively, to display the
       
  1776 time as text, the time may be formatted and placed into a descriptor using a
       
  1777 variety of formatting commands and which may or may not honour the system's
       
  1778 locale settings. The conversion between time and text may be performed the
       
  1779 other way around, so that a descriptor can be parsed and converted into a
       
  1780 TTime value.
  1773 
  1781 
  1774 In addition to setting and getting the date and time and converting between 
  1782 In addition to setting and getting the date and time and converting between 
  1775 text and time, TTime provides functions to get intervals between times and 
  1783 text and time, TTime provides functions to get intervals between times and 
  1776 standard comparison and arithmetic operators which enable time intervals to 
  1784 standard comparison and arithmetic operators which enable time intervals to 
  1777 be added or subtracted to or from the time.
  1785 be added or subtracted to or from the time.