Get-Date
Obtiene la fecha y hora actuales.
Sintaxis
Get-Date [-Formato <string>] [[-Fecha] <DateTime>] [-Day <int>] [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Hour <int>] [-Minute <int>] [-Month <int>] [-Second <int>] [-Year <int>] [<CommonParameters>]
Get-Date [-UFormat <string>] [[-Fecha] <DateTime>] [-Day <int>] [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Hour <int>] [-Minute <int>] [-Month <int>] [-Second <int>] [-Year <int>] [<CommonParameters>]
Descripción
El cmdlet Get-Date obtiene un objeto DateTime que representa la fecha actual o una fecha especificada. Puede aplicar a la fecha y la hora varios formatos de Windows y UNIX. Puede utilizar Get-Date para generar una cadena de caracteres de fecha u hora y, a continuación, enviarla a otros cmdlets o programas.
Parámetros
-Fecha <DateTime>
Especifica una fecha y hora. De manera predeterminada, Get-Date obtiene la fecha y la hora actuales del sistema.
Escriba la fecha en un formato que sea estándar para la configuración regional del sistema, como dd-MM-aaaa (alemán [Alemania]) o MM/dd/aaaa (inglés [Estados Unidos]).
¿Requerido? |
false |
¿Posición? |
1 |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-Day <int>
Especifica el día del mes que se va a mostrar. Escriba un valor comprendido entre 1 y 31. Este valor se muestra en lugar del día actual.
Si se especifica un valor superior al número de días del mes, Windows PowerShell suma el número de días al mes y muestra el resultado. Por ejemplo, "get-date -month 2 -day 31" mostrará "March 3", y no "February 31".
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-DisplayHint <DisplayHintType>
Determina qué elementos de fecha y hora se muestran.
Los valores válidos son:
-- Date: muestra solo la fecha
-- Time: muestra solo la hora
-- DateTime: muestra la fecha y la hora
DateTime es el valor predeterminado.
Este parámetro no afecta al objeto DateTime que Get-Date recupera.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Formato <string>
Muestra la fecha y la hora en el formato de Microsoft .NET Framework indicado por el especificador de formato. Escriba un especificador de formato. Para obtener una lista de los especificadores de formato disponibles, vea la clase DateTimeFormatInfo en MSDN (Microsoft Developer Network) Library, en https://go.microsoft.com/fwlink/?LinkId=143638.
Cuando se usa el parámetro Format, Windows PowerShell recupera únicamente las propiedades del objeto DateTime que necesita para mostrar la fecha en el formato especificado. Por tanto, es posible que algunos métodos y propiedades de los objetos DateTime no estén disponibles.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Hour <int>
Especifica la hora que se va a mostrar. Escriba un valor comprendido entre 1 y 23. Este valor se muestra en lugar de la hora actual.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Minute <int>
Especifica el minuto que se va a mostrar. Escriba un valor comprendido entre 1 y 59. Este valor se muestra en lugar del minuto actual.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Month <int>
Especifica el mes que se va a mostrar. Escriba un valor comprendido entre 1 y 12. Este valor se muestra en lugar del mes actual.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Second <int>
Especifica el segundo que se va a mostrar. Escriba un valor comprendido entre 1 y 59. Este valor se muestra en lugar del segundo actual.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-UFormat <string>
Muestra la fecha y la hora en formato UNIX. Para obtener una lista de los especificadores de formato, vea la sección Notas.
Cuando se usa el parámetro UFormat, Windows PowerShell recupera únicamente las propiedades del objeto DateTime que necesita para mostrar la fecha en el formato especificado. Por tanto, es posible que algunos métodos y propiedades de los objetos DateTime no estén disponibles.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Year <int>
Especifica el año que se va a mostrar. Escriba un valor comprendido entre 1 y 9999. Este valor se muestra en lugar del año actual.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
Entradas |
Ninguno No se pueden canalizar entradas a este cmdlet. |
Salidas |
System.DateTime o System.String Cuando se usan los parámetros Format o UFormat, el objeto de salida es System.String. |
Notas
De forma predeterminada, la fecha y la hora se muestran en formato largo para la configuración regional del sistema.
Cuando se canaliza una fecha a cmdlets que esperan una cadena, como Add-Content, Windows PowerShell convierte el objeto DateTime en una cadena antes de agregarlo al archivo. El formato predeterminado de ToString() es fecha corta y hora larga. Para especificar otro formato, utilice los parámetros Format o UFormat de Get-Date.
Valores de Uformat:
A continuación se indican los valores del parámetro UFormat. El formato del comando es:
get-date -uformat %<valor>
Por ejemplo:
get-date -uformat %d
Date-Time:
Fecha y hora - formato extenso
(valor predeterminado) (Friday, June 16, 2006 10:31:27 AM)
c Fecha y hora - formato abreviado (Fri Jun 16 10:31:27 2006)
Fecha:
D Fecha con el formato mm/dd/aa (06/14/06)
x Fecha con el formato estándar de la configuración local (09/12/07 para Inglés - Estados Unidos)
Año:
C Siglo (20 para 2006)
Y Año con formato de 4 dígitos (2006)
y Año con formato de 2 dígitos (06)
G Igual que 'Y'
g Igual que 'y'
Mes:
b Nombre del mes en formato abreviado (Ene)
b Nombre del mes en formato extenso (Enero)
h Igual que 'b'
m Número del mes (06)
Semana:
W Semana del año (00-52)
V Semana del año (01-53)
U Igual que 'W'
Día:
a Día de la semana, nombre abreviado (Lun)
A Día de la semana, nombre completo (Lunes)
u Día de la semana, número (Lunes = 1)
d Día del mes, 2 dígitos (05)
e Día del mes, dígito precedido de un espacio ( 5)
j Día del año - (1-366)
w Igual que 'u'
Hora:
p a. m. o p. m.
r Hora con formato de 12 horas (09:15:36 a. m.)
R Hora con formato de 24 horas, sin segundos (17:45)
T Hora con formato de 24 horas (17:45:52)
X Igual que 'T'
Z Desfase horario respecto a la hora universal coordinada (UTC) (-07)
Hora:
H Hora con formato de 24 horas (17)
I Hora con formato de 12 horas (05)
k Igual que 'H'
l Igual que 'I' (I mayúscula = L minúscula)
Minutos y segundos:
M Minutos (35)
S Segundos (05)
s Segundos trascurridos desde 1 de enero de 1970 00:00:00 (1150451174,95705)
Caracteres especiales:
n Carácter de nueva línea (\n)
t Carácter de tabulación (\t)
Ejemplo 1
C:\PS>get-date -DisplayHint date
Tuesday, June 13, 2006
Descripción
-----------
Este comando recupera un objeto DateTime, pero muestra únicamente la fecha. Usa el parámetro DisplayHint para indicar que solo debe mostrarse la fecha.
Ejemplo 2
C:\PS>get-date -format g
6/13/2006 12:43 PM
Descripción
-----------
Este comando recupera la fecha y la hora actuales y les aplica el formato corto. Usa el especificador de formato "g" de .NET Framework (General [fecha y hora cortas]) para especificar el formato.
Ejemplo 3
C:\PS>get-date -uformat "%Y / %m / %d / %A / %Z"
2006 / 06 / 13 / Tuesday / -07
Descripción
-----------
Este comando recupera la fecha y la hora actuales y les aplica el formato especificado por el comando. En este caso, el formato incluye el año completo (%Y), el número de mes con dos dígitos (%m), la fecha (%d), el día completo de la semana (%A) y el desfase horario respecto a UTC ("Zulu").
Ejemplo 4
C:\PS>(get-date -year 2000 -month 12 -day 31).dayofyear
366
Descripción
-----------
Este comando muestra el día del año de la fecha actual. Por ejemplo, el 31 de diciembre es el día 365 del año 2006, pero es el día 366 del año 2000.
Ejemplo 5
C:\PS>$a = get-date
C:\PS> $a.IsDaylightSavingTime()
True
Descripción
-----------
Estos comandos indican si la fecha y hora actuales se han ajustado al cambio de horario de verano o invierno en la configuración local.
El primer comando crea una variable denominada $a y, a continuación, asigna a esta variable el objeto recuperado por Get-Date. A continuación, aplica el método IsDaylightSavingTime al objeto guardado en $a.
Para ver los métodos y propiedades del objeto DateTime, escriba:
"get-date | get-member".
Ejemplo 6
C:\PS>$a = get-date
C:\PS> $a.ToUniversalTime()
Tuesday, June 13, 2006 8:09:19 PM
Descripción
-----------
Estos comandos transforman la fecha y hora actual en la hora UTC.
El primer comando crea una variable denominada $a y, a continuación, asigna a esta variable el objeto recuperado por Get-Date. A continuación, aplica el método ToUniversalTime al objeto guardado en $a.
Ejemplo 7
C:\PS>$a = get-wmiobject win32_bios -computer server01
$a | format-list -property Name, @{Label="BIOS Age"; `
Expression={(get-date) - $_.ConvertToDateTime($_.ReleaseDate)}}
Name : Default System BIOS
BIOS Age : 1345.17:31:07.1091047
Descripción
-----------
Instrumental de administración de Windows (WMI) usa un objeto date-time diferente al objeto date-time de .NET Framework que Get-Date devuelve. Para usar la información del objeto date-time de WMI en un comando con información del objeto date-time de Get-Date, debe usar el método ConvertToDateTime para convertir los objetos CIM_DATETIME de WMI en objetos DateTime de .NET Framework.
Los comandos de este ejemplo muestran el nombre y la antigüedad del BIOS en el equipo remoto Server01.
El primer comando utiliza el cmdlet Get-WmiObject para obtener una instancia de la clase Win32_BIOS en Server01 y, a continuación, la almacena en la variable $a.
El segundo comando usa el operador de canalización (|) para enviar el objeto de WMI almacenado en $a al cmdlet Format-List. El parámetro Property de Format-List se usa para especificar las dos propiedades que se van a mostrar en la lista, "Name" y "BIOS Age". La propiedad "BIOS Age" se especifica en una tabla hash. La tabla contiene la clave Label, que especifica el nombre de la propiedad, y la clave Expression, que contiene la expresión que calcula la antigüedad del BIOS. La expresión usa el método ConvertToDateTime para convertir cada instancia de ReleaseDate en un objeto DateTime de .NET Framework. A continuación, el valor se resta del valor del cmdlet Get-Date, que, sin parámetros, obtiene la fecha actual.
El carácter de acento grave (`) es el carácter de continuación de línea en Windows PowerShell.
Ejemplo 8
C:\PS>get-date
Tuesday, June 13, 2006 12:43:42 PM
Descripción
-----------
Este comando obtiene un objeto DateTime y muestra la fecha y la hora actuales en formato largo para la configuración regional del sistema, como si se escribiera "get-date -format F".
Ejemplo 9
C:\PS>get-date
C:\PS> Tuesday, September 26, 2006 11:25:31 AM
c:\PS>(get-date).ToString()
9/26/2006 11:25:31 AM
C:\PS>get-date | add-content test.txt
# Adds 9/26/2006 11:25:31 AM
C:\PS>get-date -format F | add-content test.txt
# Adds Tuesday, September 26, 2006 11:25:31 AM
Descripción
-----------
Estos comandos muestran cómo utilizar Get-Date con Add-Content y otros cmdlets que convierten el objeto DateTime generado por Get-Date en una cadena.
El primer comando muestra que el formato de presentación predeterminado del comando "get-date" es el formato de fecha larga y hora larga.
El segundo comando muestra que el formato de presentación predeterminado del método ToString() del objeto DateTime es el formato de fecha corta y hora corta.
El tercer comando usa un operador de canalización para enviar el objeto DateTime al cmdlet Add-Content, que agrega el contenido al archivo Test.txt. Dado que Add-Content utiliza el método ToString() del objeto DateTime, la fecha que se agrega tiene el formato de fecha corta y hora corta.
El cuarto comando utiliza el parámetro Format de Get-Date para especificar el formato. Cuando se utiliza el parámetro Format o UFormat, Get-Date genera una cadena en lugar de un objeto DateTime. A continuación, cuando se envía la cadena a Add-Content, se agrega al archivo Test.txt sin que se realice cambio alguno.