Get-Date

Sintaxis

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

Description

El Get-Date cmdlet obtiene un objeto DateTime que representa la fecha actual o una fecha especificada. Get-Date puede dar formato a la fecha y hora en varios formatos .NET y UNIX. Puede usar Get-Date para generar una cadena de caracteres de fecha u hora y, a continuación, enviar la cadena a otros cmdlets o programas.

Get-Date usa la configuración de referencia cultural actual del sistema operativo para determinar cómo se da formato a la salida. Para ver la configuración del equipo, use (Get-Culture).DateTimeFormat.

Ejemplos

Ejemplo 1: Obtener la fecha y hora actuales

En este ejemplo, Get-Date muestra la fecha y hora actuales del sistema. La salida está en los formatos long-date y long-time.

Get-Date

Tuesday, June 25, 2019 14:53:32

Ejemplo 2: Obtener elementos de la fecha y hora actuales

En este ejemplo se muestra cómo usar Get-Date para obtener el elemento date o time. El parámetro usa los argumentos Date, Time o DateTime.

Get-Date -DisplayHint Date

Tuesday, June 25, 2019

Get-Date usa el parámetro DisplayHint con el argumento Date para obtener solo la fecha.

Ejemplo 3: Obtención de la fecha y hora con un especificador de formato .NET

En este ejemplo, se usa un especificador de formato .NET para personalizar el formato de la salida. La salida es un objeto String .

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

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

Get-Date usa el parámetro Format para especificar varios especificadores de formato.

Los especificadores de formato .NET usados en este ejemplo se definen de la siguiente manera:

Especificador	Definición
dddd	Día de la semana: nombre completo
MM	Número de mes.
dd	Día del mes : 2 dígitos
yyyy	Año en formato de 4 dígitos
HH:mm	Hora en formato de 24 horas: sin segundos
K	Desplazamiento de zona horaria de coordenadas horarias universales (UTC)

Para obtener más información sobre los especificadores de formato de .NET, vea Cadenas de formato de fecha y hora personalizadas.

Ejemplo 4: Obtener la fecha y hora con un especificador UFormat

En este ejemplo, se usan varios especificadores de formato UFormat para personalizar el formato de la salida. La salida es un objeto String .

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

Tuesday 06/25/2019 16:19 -07

Get-Date usa el parámetro UFormat para especificar varios especificadores de formato.

Los especificadores de formato UFormat usados en este ejemplo se definen de la siguiente manera:

Especificador	Definición
%A	Día de la semana: nombre completo
%m	Número de mes.
%d	Día del mes : 2 dígitos
%Y	Año en formato de 4 dígitos
%R	Hora en formato de 24 horas: sin segundos
%Z	Desplazamiento de zona horaria de coordenadas horarias universales (UTC)

Para obtener una lista de especificadores de formato UFormat válidos, vea la sección Notas.

Ejemplo 5: Obtener el día de una fecha del año

En este ejemplo, se usa una propiedad para obtener el día numérico del año.

El calendario gregoriano tiene 365 días, excepto los años bisiestos que tienen 366 días. Por ejemplo, el 31 de diciembre de 2020 es el día 366.

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

366

Get-Date usa tres parámetros para especificar la fecha: Year, Month y Day. El comando se ajusta con paréntesis para que la propiedad DayofYear evalúe el resultado.

Ejemplo 6: Comprobación de si se ajusta una fecha para el horario de verano

En este ejemplo se usa un método booleano para comprobar si una fecha se ajusta mediante el horario de verano.

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

True

Una variable almacena $DST el resultado de Get-Date. $DST usa el método IsDaylightSavingTime para probar si la fecha se ajusta para el horario de verano.

Ejemplo 7: Convertir la hora actual a hora UTC

En este ejemplo, la hora actual se convierte a hora UTC. El desplazamiento UTC de la configuración regional del sistema se usa para convertir la hora. Una tabla de la sección Notas enumera los especificadores de formato UFormat válidos.

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 usa el parámetro UFormat con especificadores de formato para mostrar la fecha y hora actuales del sistema. El especificador de formato %Z representa el desplazamiento UTC de -07.

La $Time variable almacena la fecha y hora actuales del sistema. $Time usa el ToUniversalTime() método para convertir la hora en función del desplazamiento UTC del equipo.

Ejemplo 8: Crear una marca de tiempo

En este ejemplo, un especificador de formato crea un objeto String de marca de tiempo para un nombre de directorio. La marca de tiempo incluye la fecha, la hora y el desplazamiento 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

La $timestamp variable almacena los resultados de un Get-Date comando. Get-Dateusa el parámetro Format con el especificador de formato en minúsculas o para crear un objeto String de marca de tiempo. El objeto se envía por la canalización a ForEach-Object. Un ScriptBlock contiene la $_ variable que representa el objeto de canalización actual. La cadena de marca de tiempo está delimitada por dos puntos que se reemplazan por puntos.

New-Item usa el parámetro Path para especificar la ubicación de un nuevo directorio. La ruta de acceso incluye la $timestamp variable como nombre del directorio. El parámetro Type especifica que se crea un directorio.

Ejemplo 9: Convertir una marca de tiempo de Unix

En este ejemplo se convierte una hora de UNIX (representada por el número de segundos desde 1970-01-01 0:00:00) en DateTime.

Get-Date -UnixTimeSeconds 1577836800

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

Ejemplo 10: Devolver un valor de fecha interpretado como UTC

En este ejemplo se muestra cómo interpretar un valor de fecha como su equivalente UTC. En el ejemplo, esta máquina se establece en Hora estándar del Pacífico. De forma predeterminada, Get-Date devuelve valores para esa zona horaria. Use el parámetro AsUTC para convertir el valor a la hora utc equivalente.

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

Ejemplo 11: Mostrar referencia cultural invariable

ToString() convierte un objeto DateTime en string mediante la configuración de referencia cultural actual. Sin embargo, la interpretación de expresiones de PowerShell siempre usa la configuración de referencia cultural invariable.

Por ejemplo, en un sistema con la en-US referencia cultural en vigor, el ToString() método da formato a la fecha mediante la configuración de referencia en-US cultural.

# 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

Parámetros

-AsUTC

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-UnixTimeSeconds

-Year

Entradas

DateTime

Puede canalizar un objeto DateTime a este cmdlet.

Salidas

DateTime

De forma predeterminada, este cmdlet devuelve un objeto DateTime .

Cuando se envía un objeto DateTime a una canalización a un cmdlet como Add-Content que espera la entrada de cadena, PowerShell convierte el objeto en un objeto String .

ToString() Convierte un objeto DateTime en una cadena mediante la configuración de referencia cultural actual. Sin embargo, la interpretación de expresiones de PowerShell siempre usa la configuración de referencia cultural invariable. Para ver cómo la referencia cultural invariable es diferente, consulte el ejemplo 11.

Para mostrar las propiedades y los métodos de un objeto, envíe el objeto a la canalización a Get-Member. Por ejemplo, Get-Date | Get-Member.

String

Cuando se usan los parámetros Format o UFormat , este cmdlet devuelve objetos String .

Notas

Los formatos predeterminados para la salida de los objetos DateTime son formatos de fecha larga y de tiempo largo para la configuración regional seleccionada actualmente.

Los especificadores UFormat válidos se muestran en la tabla siguiente:

Especificador de formato	Significado	Ejemplo
%A	Día de la semana: nombre completo	Lunes
%a	Día de la semana: nombre abreviado	Lu.
%B	Nombre del mes: completo	January
%b	Nombre del mes: abreviado	Jan
%C	Siglo	20 para 2019
%c	Fecha y hora: abreviada	Thu Jun 27 08:44:18 2019
%D	Fecha en formato mm/dd/aaaa	06/27/19
%d	Día del mes : 2 dígitos	05
%e	Día del mes: precedido por un espacio si solo hay un solo dígito	<espacio>5
%F	Fecha en formato AAAA-mm-dd, igual a %Y-%m-%d (formato de fecha ISO 8601)	2019-06-27
%G	Año de fecha de la semana ISO (año que contiene el jueves de la semana)
%g	Igual que 'G' - 2 dígitos
%H	Hora en formato de 24 horas	17
%h	Igual que 'b'
%I	Hora en formato de 12 horas	05
%j	Día del año	1-366
%k	Igual que 'H'
%l	Igual que 'I' (mayúscula i)	05
%M	Minutos	35
%m	Número de mes.	06
%n	carácter de nueva línea
%p	a. m. o p. m.
%R	Hora en formato de 24 horas :sin segundos	17:45
%r	Hora en formato de 12 horas	09:15:36 AM
%S	Segundos	05
%s	Segundos transcurridos desde el 1 de enero de 1970 00:00:00 (UTC)	1150451174
%t	Carácter de tabulación horizontal
%T	Hora en formato de 24 horas	17:45:52
%U	Igual que 'W'
%u	Día numérico de la semana (1-7) (cambiado en PowerShell 7.2)	Lunes = 1, domingo = 7
%V	Semana del año	01-53
%w	Día numérico de la semana (0-6)	Domingo = 0, sábado = 6
%W	Semana del año	00-52
%X	Igual que 'T'
%x	Fecha en formato estándar para la configuración regional	27/06/19 para inglés-EE. UU.
%Y	Año en formato de 4 dígitos	2019
%y	Año en formato de 2 dígitos	19
%Z	Desplazamiento de zona horaria de coordenadas horarias universales (UTC)	-07

Vínculos relacionados

• ForEach-Object
• Get-Culture
• Get-Member
• New-Item
• New-TimeSpan
• Set-Date
• Establecer referencia cultural