Skip to content

Update Docs for DateTime.Ticks to explain it depends on the time zone of the object instance. #3355

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Jan 21, 2020
Merged

Update Docs for DateTime.Ticks to explain it depends on the time zone of the object instance. #3355

Changes from 6 commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
72fc0f7
Update DateTime.xml
AWilco Oct 16, 2019
91efc7a
Update DateTime.xml Ticks Property Remarks
AWilco Dec 12, 2019
7a6929b
Update xml/System/DateTime.xml
AWilco Dec 19, 2019
4903125
Update xml/System/DateTime.xml
AWilco Dec 19, 2019
c49b128
Update xml/System/DateTime.xml
AWilco Dec 19, 2019
7f1c17e
Update xml/System/DateTime.xml
AWilco Dec 19, 2019
38426da
Update xml/System/DateTime.xml
AWilco Jan 21, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 7 additions & 3 deletions xml/System/DateTime.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6825,9 +6825,13 @@ The following example demonstrates the <xref:System.DateTime.Parse%28System.Stri
## Remarks
A single tick represents one hundred nanoseconds or one ten-millionth of a second. There are 10,000 ticks in a millisecond, or 10 million ticks in a second.

The value of this property represents the number of 100-nanosecond intervals that have elapsed since 12:00:00 midnight, January 1, 0001 (0:00:00 UTC on January 1, 0001, in the Gregorian calendar), which represents <xref:System.DateTime.MinValue?displayProperty=nameWithType>. It does not include the number of ticks that are attributable to leap seconds.


The value of this property represents the number of 100-nanosecond intervals that have elapsed since 12:00:00 midnight, January 1, 0001 in the Gregorian calendar, which represents <xref:System.DateTime.MinValue>. It does not include the number of ticks that are attributable to leap seconds.
If the DateTime object has its `Kind` property set to `Local`, its ticks represent the time elapsed time since 12:00:00 midnight, January 1, 0001 in the local time as specified by the current time zone setting.
If the DateTime object has Kind property set to Utc, that means the ticks inside this object is representing the time elapsed time since 12:00:00 midnight, January 1, 0001 in the Coordinated Universal Time.
If the `DateTime` object has its `Kind` property set to `Unspecified`, its ticks represent the time elapsed time since 12:00:00 midnight, January 1, 0001 in the unknown time zone.

In general, the ticks represent the time according to the time zone specified by the `Kind` property.


## Examples
The following example uses the <xref:System.DateTime.Ticks%2A> property to display the number of ticks that have elapsed since the beginning of the twenty-first century and to instantiate a <xref:System.TimeSpan> object. The <xref:System.TimeSpan> object is then used to display the elapsed time using several other time intervals.
Expand Down