TimeZone.ToLocalTime(DateTime) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает локальное время, соответствующее заданному значению даты и времени.
public:
virtual DateTime ToLocalTime(DateTime time);public virtual DateTime ToLocalTime(DateTime time);abstract member ToLocalTime : DateTime -> DateTime
override this.ToLocalTime : DateTime -> DateTimePublic Overridable Function ToLocalTime (time As DateTime) As DateTimeПараметры
- time
- DateTime
Время в формате UTC.
Возвращаемое значение
DateTime Объект, значение которого соответствует местному timeвремени.
Комментарии
В следующей таблице показана связь между параметром time и DateTime значением, возвращаемым этим методом.
time Параметр |
Behavior | Возвращаемое значение |
|---|---|---|
| Время универсального времени (UTC) (DateTimeKind.Utcutc). | Преобразует время из UTC в местное время. |
DateTime Объект, значение которого соответствует местному timeвремени. |
| Локальное время (DateTimeKind.Local). | Преобразование не требуется. | То же DateTime значение, представленное параметром time . |
| Неопределенное время (DateTimeKind.Unspecified). | Предполагает, что время в формате UTC и преобразует его из UTC в местное время. |
DateTime Объект, значение которого соответствует местному timeвремени. |
Если в локальном часовом поясе наблюдается летнее время, ToLocalTime применяется текущее правило time корректировки при выполнении преобразования.
Note
Метод ToLocalTime распознает только текущее правило корректировки времени летнего времени для локального часового пояса. В результате гарантируется точное возвращение локального времени, соответствующего определенному времени UTC только в течение периода, в течение которого действует последнее правило корректировки. Он может возвращать неточные результаты, если time это историческое значение даты и времени, которое было подвержено предыдущему правилу корректировки.
Метод ToLocalTime соответствует методу TimeZoneInfo.ConvertTimeFromUtc с заданным destinationTimeZone параметром TimeZoneInfo.Local. По возможности используйте TimeZoneInfo.ConvertTimeFromUtc метод.
Примечания для тех, кто наследует этот метод
Хотя это не обязательно, в большинстве случаев производные классы должны переопределить реализацию этого метода по умолчанию. Поведение реализации по умолчанию зависит от Kind свойства time параметра. Если значение равно Local, этот метод возвращает time без изменений. Если его значение равно или Utc, этот метод предполагаетUnspecified, что time это UTC и преобразует его в локальное системное время без вызова GetUtcOffset(DateTime) метода.
