dotnet / dotnet/docs

Please add a section for `Misleading` time

Open
#36,463 0 comments 0 reactions 0 assignees View on GitHub
:watch: Not Triaged dotnet-fundamentals/svc
Dominant language
No language data
Stars
4.8k
Forks
6.1k
Avg merge
19h 10m
Merged PRs (30d)
268

Description

Microsoft support technicians have a tendency to write signatures during the summer that include times listed as EST.

Your current table has:

| Term | Definition |
| --------------- | ---------- |
| Ambiguous time | A time that can be mapped to two different times in a single time zone. It occurs when the clock time is adjusted back in time, such as during the transition from a time zone's daylight saving time to its standard time. For example, if this transition occurs on a particular day at 2:00 A.M. and causes the time to change to 1:00 A.M., each time interval between 1:00 A.M. and 1:59:59 A.M. can be interpreted as either a standard time or a daylight saving time. |
| Invalid time | A nonexistent time that is an artifact of the transition from standard time to daylight saving time. It occurs when the clock time is adjusted forward in time, such as during the transition from a time zone's standard time to its daylight saving time. For example, if this transition occurs on a particular day at 2:00 A.M. and causes the time to change to 3:00 A.M., each time interval between 2:00 A.M. and 2:59:59 A.M. is invalid. |
| Transition time | Information about a specific time change, such as the change from daylight saving time to standard time or vice versa, in a particular time zone. |

It should really have:

| Term | Definition |
| --------------- | ---------- |
| Ambiguous time | A time that can be mapped to two different times in a single time zone. It occurs when the clock time is adjusted back in time, such as during the transition from a time zone's daylight saving time to its standard time. For example, if this transition occurs on a particular day at 2:00 A.M. and causes the time to change to 1:00 A.M., each time interval between 1:00 A.M. and 1:59:59 A.M. can be interpreted as either a standard time or a daylight saving time. |
| Invalid time | A nonexistent time that is an artifact of the transition from standard time to daylight saving time. It occurs when the clock time is adjusted forward in time, such as during the transition from a time zone's standard time to its daylight saving time. For example, if this transition occurs on a particular day at 2:00 A.M. and causes the time to change to 3:00 A.M., each time interval between 2:00 A.M. and 2:59:59 A.M. is invalid. |
| Transition time | Information about a specific time change, such as the change from daylight saving time to standard time or vice versa, in a particular time zone. |
| **Misleading time** | **A time that doesn't exist because the time zone is inoperative on that date which means that a reader will be forced to guess whether the author meant the other corresponding time zone for the same region but with the same number, or the corresponding time zone for the same region but shifted according to the relative offset between the two time zones.** |

Note that this additional category could be described as an `Invalid time`, but your current definition of `Invalid time` is reasonable and useful to cover a different category and thus shouldn't be used to cover this category.

Similarly, while it is correct to call a date-time for an inoperative time zone an `Ambiguous time`, it does not fit the definition above and that category benefits from having a distinct descriptor.

---
#### Document Details

⚠ *Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.*

* ID: 196fffa3-d004-3650-71f7-a8fadce96bb4
* Version Independent ID: 7d2e4387-105b-131a-e8bd-793cfab6117f
* Content: [Time zone overview](https://learn.microsoft.com/en-us/dotnet/standard/datetime/time-zone-overview)
* Content Source: [docs/standard/datetime/time-zone-overview.md](https://github.com/dotnet/docs/blob/main/docs/standard/datetime/time-zone-overview.md)
* Product: **dotnet-fundamentals**
* GitHub Login: @adegeo
* Microsoft Alias: **adegeo**

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.