Get-Date

Синтаксис

Get-Date
   [[-Date] <DateTime>]
   [-Year <Int32>]
   [-Month <Int32>]
   [-Day <Int32>]
   [-Hour <Int32>]
   [-Minute <Int32>]
   [-Second <Int32>]
   [-Millisecond <Int32>]
   [-DisplayHint <DisplayHintType>]
   [-Format <String>]
   [-AsUTC]
   [<CommonParameters>]

Get-Date
   [[-Date] <DateTime>]
   [-Year <Int32>]
   [-Month <Int32>]
   [-Day <Int32>]
   [-Hour <Int32>]
   [-Minute <Int32>]
   [-Second <Int32>]
   [-Millisecond <Int32>]
   [-DisplayHint <DisplayHintType>]
   -UFormat <String>
   [<CommonParameters>]

Get-Date
   -UnixTimeSeconds <Int64>
   [-Year <Int32>]
   [-Month <Int32>]
   [-Day <Int32>]
   [-Hour <Int32>]
   [-Minute <Int32>]
   [-Second <Int32>]
   [-Millisecond <Int32>]
   [-DisplayHint <DisplayHintType>]
   [-Format <String>]
   [-AsUTC]
   [<CommonParameters>]

Get-Date
   -UnixTimeSeconds <Int64>
   [-Year <Int32>]
   [-Month <Int32>]
   [-Day <Int32>]
   [-Hour <Int32>]
   [-Minute <Int32>]
   [-Second <Int32>]
   [-Millisecond <Int32>]
   [-DisplayHint <DisplayHintType>]
   -UFormat <String>
   [<CommonParameters>]

Описание

Командлет Get-Date получает объект DateTime , представляющий текущую дату или указанную дату. Get-Date может форматировать дату и время в нескольких форматах .NET и UNIX. Можно использовать Get-Date для создания строки символов даты или времени, а затем отправки строки другим командлетам или программам.

Get-Date использует текущие параметры языка и региональных параметров операционной системы для определения форматирования выходных данных. Чтобы просмотреть параметры компьютера, используйте (Get-Culture).DateTimeFormat.

Примеры

Пример 1. Получение текущей даты и времени

В этом примере Get-Date отображается текущая системная дата и время. Выходные данные относятся к формату long-date и long-time.

Get-Date

Tuesday, June 25, 2019 14:53:32

Пример 2. Получение элементов текущей даты и времени

В этом примере показано, как использовать Get-Date для получения элемента даты или времени. Параметр использует аргументы Date, Time или DateTime.

Get-Date -DisplayHint Date

Tuesday, June 25, 2019

Get-Dateиспользует параметр DisplayHint с аргументом Date, чтобы получить только дату.

Пример 3. Получение даты и времени с помощью описателя формата .NET

В этом примере описатель формата .NET используется для настройки формата выходных данных. Выходные данные — это объект String .

Get-Date -Format "dddd MM/dd/yyyy HH:mm K"

Tuesday 06/25/2019 16:17 -07:00

Get-Dateиспользует параметр Format для указания нескольких описателей формата.

Описатели формата .NET, используемые в этом примере, определяются следующим образом:

класса хранения	Определение
dddd	День недели - полное имя
MM	Номер месяца.
dd	День месяца — 2 цифры
yyyy	Год в формате 4 цифр
HH:mm	Время в 24-часовом формате — нет секунд
K	Смещение часового пояса из универсальной координаты времени (UTC)

Дополнительные сведения об описателях формата .NET см. в строках настраиваемого формата даты и времени.

Пример 4. Получение даты и времени с помощью описателя UFormat

В этом примере для настройки формата выходных данных используются несколько описателей формата UFormat . Выходные данные — это объект String .

Get-Date -UFormat "%A %m/%d/%Y %R %Z"

Tuesday 06/25/2019 16:19 -07

Get-Dateиспользует параметр UFormat для указания нескольких описателей формата.

Описатели формата UFormat , используемые в этом примере, определяются следующим образом:

класса хранения	Определение
%A	День недели - полное имя
%m	Номер месяца.
%d	День месяца — 2 цифры
%Y	Год в формате 4 цифр
%R	Время в 24-часовом формате — нет секунд
%Z	Смещение часового пояса из универсальной координаты времени (UTC)

Список допустимых описателей формата UFormat см. в разделе "Заметки ".

Пример 5. Получение дня даты года

В этом примере свойство используется для получения числовых дней года.

Григорианский календарь имеет 365 дней, за исключением високосных лет, которые имеют 366 дней. Например, 31 декабря 2020 г. — день 366.

(Get-Date -Year 2020 -Month 12 -Day 31).DayOfYear

366

Get-Date использует три параметра, чтобы указать дату: год, месяц и день. Команда упаковывается в скобки, чтобы результат вычислялся свойством DayofYear .

Пример 6. Проверьте, корректируется ли дата для летнего времени

В этом примере используется логический метод для проверки того, корректируется ли дата по летнему времени.

$DST = Get-Date
$DST.IsDaylightSavingTime()

True

Переменная $DST сохраняет результат Get-Date. $DSTиспользует метод IsDaylightSavingTime для проверки того, корректируется ли дата для летнего времени.

Пример 7. Преобразование текущего времени в utc

В этом примере текущее время преобразуется в время UTC. Смещение в формате UTC для языкового стандарта системы используется для преобразования времени. Таблица в разделе "Заметки " содержит допустимые описатели формата UFormat .

Get-Date -UFormat "%A %B/%d/%Y %T %Z"
$Time = Get-Date
$Time.ToUniversalTime()

Wednesday June/26/2019 10:45:26 -07

Wednesday, June 26, 2019 17:45:26

Get-Dateиспользует параметр UFormat с описателями формата для отображения текущей системной даты и времени. Описатель формата %Z представляет смещение в формате UTC от -07.

Переменная $Time сохраняет текущую системную дату и время. $TimeToUniversalTime() использует метод для преобразования времени на основе смещения utc компьютера.

Пример 8. Создание метки времени

В этом примере описатель формата создает объект timestamp String для имени каталога. Метка времени включает смещение даты, времени и времени в формате UTC.

$timestamp = Get-Date -Format o | ForEach-Object { $_ -replace ":", "." }
New-Item -Path C:\Test\$timestamp -Type Directory

Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         6/27/2019    07:59                2019-06-27T07.59.24.4603750-07.00

Переменная $timestamp сохраняет результаты Get-Date команды. Get-Dateиспользует параметр Format с описательом формата нижнего регистра o для создания объекта timestamp String. Объект отправляется вниз конвейера ForEach-Object. ScriptBlock содержит $_ переменную, представляющую текущий объект конвейера. Строка метки времени разделена двоеточиями, которые заменяются периодами.

New-Itemиспользует параметр Path, чтобы указать расположение для нового каталога. Путь включает $timestamp переменную в качестве имени каталога. Параметр Type указывает, что создается каталог.

Пример 9. Преобразование метки времени Unix

В этом примере время в формате Unix (представленное количеством секунд с 0:00:00 01.01.1970) преобразуется в тип DateTime.

Get-Date -UnixTimeSeconds 1577836800

Wednesday, January 01, 2020 12:00:00 AM

Пример 10. Возврат значения даты, интерпретированного как UTC

В этом примере показано, как интерпретировать значение даты как эквивалент UTC. Например, для этого компьютера задано значение Pacific Standard Time. По умолчанию Get-Date возвращает значения для этого часового пояса. Используйте параметр AsUTC для преобразования значения в эквивалентное время в формате UTC.

PS> Get-TimeZone

Id                         : Pacific Standard Time
DisplayName                : (UTC-08:00) Pacific Time (US & Canada)
StandardName               : Pacific Standard Time
DaylightName               : Pacific Daylight Time
BaseUtcOffset              : -08:00:00
SupportsDaylightSavingTime : True

PS> (Get-Date -Date "2020-01-01T00:00:00").Kind
Unspecified

PS> Get-Date -Date "2020-01-01T00:00:00"

Wednesday, January 1, 2020 12:00:00 AM

PS> (Get-Date -Date "2020-01-01T00:00:00" -AsUTC).Kind
Utc

PS> Get-Date -Date "2020-01-01T00:00:00" -AsUTC

Wednesday, January 1, 2020 8:00:00 AM

Пример 11. Отображение инвариантного языка и региональных параметров

Объект ToString() DateTime преобразует строку с помощью текущего параметра языка и региональных параметров. Однако интерпретация выражений PowerShell всегда использует инвариантный параметр языка и региональных параметров.

Например, в системе с en-US языком и региональными ToString() параметрами метод форматирует дату с помощью en-US параметров языка и региональных параметров.

# Get date using current culture en-US
(Get-Date 2024-03-19).ToString()

3/19/2024 12:00:00 AM

# Get date using invariant culture
"$(Get-Date 2024-03-19)"

03/19/2024 00:00:00

Параметры

-AsUTC

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-UnixTimeSeconds

-Year

Входные данные

DateTime

Объект DateTime можно передать в этот командлет.

Выходные данные

DateTime

По умолчанию этот командлет возвращает объект DateTime .

Когда объект DateTime отправляется по конвейеру в командлет, напримерAdd-Content, ожидающий ввода строк, PowerShell преобразует объект в объект String.

Объект ToString() DateTime преобразуется в строку с помощью текущего параметра языка и региональных параметров. Однако интерпретация выражений PowerShell всегда использует инвариантный параметр языка и региональных параметров. Сведения о том, как инвариантные региональные параметры отличаются, см . в примере 11.

Чтобы отобразить свойства и методы объекта, отправьте объект вниз по конвейеру Get-Member. Например, Get-Date | Get-Member.

String

При использовании параметров Format или UFormat этот командлет возвращает объекты String .

Примечания

Форматы по умолчанию для выходных данных объектов DateTime — это форматы длительной даты и длительного времени для выбранного языкового стандарта.

Допустимые описатели UFormat отображаются в следующей таблице:

Спецификатор формата	Значение	Пример
%A	День недели - полное имя	Понедельник
%a	День недели - сокращенное имя	Пн
%B	Имя месяца — полное	января
%b	Имя месяца — сокращено	Янв
%C	Век	20 за 2019 год
%c	Дата и время — сокращено	Чт 27 08:44:18 2019
%D	Дата в формате мм/дд/гг	06/27/19
%d	День месяца — 2 цифры	05
%e	День месяца — перед пробелом, если только одна цифра	<пробел>5
%F	Дата в формате гггг-мм-дд, равный %Y-%m-d (формат даты ISO 8601)	2019-06-27
%G	Дата недели ISO (год, содержащий четверг недели)
%g	То же, что и "G" - 2 цифры
%H	Час в 24-часовом формате	17
%h	То же самое, что "b"
%I	Час в формате 12 часов	05
%j	День года	1-366
%k	То же самое, что "H"
%l	То же самое, что "I" (верхний регистр i)	05
%M	Минуты	35
%m	Номер месяца.	06
%n	символ новой строки
%p	До или после полудня
%R	Время в формате 24 часа -нет секунд	17:45
%r	Время в формате 12 часов	09:15:36
%S	сек.	05
%s	Секунды истекли с 1 января 1970 г. 00:00:00 (UTC)	1150451174
%t	Символ горизонтальной вкладки
%T	Время в 24-часовом формате	17:45:52
%U	То же самое, что "W"
%u	Числовой день недели (1-7) (изменено в PowerShell 7.2)	Понедельник = 1, воскресенье = 7
%V	Неделя года	01-53
%w	Числовой день недели (0-6)	Воскресенье = 0, суббота = 6
%W	Неделя года	00-52
%X	То же самое, что "T"
%x	Дата в стандартном формате для языкового стандарта	06.27.19 для английского языка США
%Y	Год в формате 4 цифр	2019
%y	Год в формате с 2 цифрами	19
%Z	Смещение часового пояса из универсальной координаты времени (UTC)	-07

Связанные ссылки

• ForEach-Object
• Get-Culture
• Get-Member
• New-Item
• New-TimeSpan
• Set-Date
• Настройка языка и региональных параметров