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. |