Get-Date

Artigo
10/30/2009

Obtém a data e a hora atual.

Sintaxe

Get-Date [-Formato <string>] [[-Date] <DateTime>] [-Day <int>] [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Hour <int>] [-Minute <int>] [-Month <int>] [-Second <int>] [-Year <int>] [<CommonParameters>]

Get-Date [-UFormat <string>] [[-Date] <DateTime>] [-Day <int>] [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Hour <int>] [-Minute <int>] [-Month <int>] [-Second <int>] [-Year <int>] [<CommonParameters>]

Descrição

O cmdlet Get-Date obtém um objeto DateTime que representa a data atual ou uma data especificada por você. Ele pode formatar a data e a hora em vários formatos do Windows e do UNIX. É possível usar o Get-Date para gerar uma cadeia de caracteres de data ou de hora e enviá-la a outros cmdlets ou programas.

Parâmetros

-Date <DateTime>

Especifica uma data e hora. Por padrão, o Get-Date obtém a data e a hora atuais do sistema.

Digite a data em um formato que seja o padrão da localidade do sistema, como dd-MM-aaaa (Alemão [Alemanha]) ou MM/dd/aaaa (Inglês [Estados Unidos]).

Necessário?	false
Posição?	1
Valor padrão
Aceitar entrada do pipeline?	true (ByValue, ByPropertyName)
Aceitar caracteres curinga?	false

-Day <int>

Especifica o dia do mês exibido. Digite um valor entre 1 e 31. Esse valor será exibido no lugar do dia atual.

Se você especificar um valor superior ao número de dias no mês, o Windows PowerShell adicionará o número de dias ao mês e exibirá o resultado. Por exemplo, "get-date -month 2 -day 31" exibe "3 de março", não "31 de fevereiro".

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-DisplayHint <DisplayHintType>

Determina quais elementos da data e hora serão exibidos.

Os valores válidos são:

-- Date: exibe somente a data

-- Time: exibe somente a hora

-- DateTime: exibe a data e a hora

DateTime é o padrão.

Esse parâmetro não afeta o objeto DateTime que Get-Date recupera.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Formato <string>

Exibe a data e a hora no formato Microsoft .NET Framework indicado pelo especificador de formato. Insira um especificador de formato. Para obter uma lista de especificadores de formato disponíveis, consulte "DateTimeFormatInfo Class" (em inglês) na biblioteca MSDN (Microsoft Developer Network) em https://go.microsoft.com/fwlink/?LinkId=143638.

Quando você usar o parâmetro Format, o Windows PowerShell irá recuperar somente as propriedades do objeto DateTime necessárias para exibir a data no formato especificado por você. Dessa forma, algumas das propriedades e métodos dos objetos DateTime podem não estar disponíveis.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Hour <int>

Especifica a hora exibida. Digite um valor entre 1 e 23. Esse valor será exibido no lugar da hora atual.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Minute <int>

Especifica o minuto exibido. Digite um valor entre 1 e 59. Esse valor será exibido no lugar do minuto atual.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Month <int>

Especifica o mês exibido. Digite um valor entre 1 e 12. Esse valor será exibido no lugar do mês atual.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Second <int>

Especifica o segundo exibido. Digite um valor entre 1 e 59. Esse valor será exibido no lugar do segundo atual.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-UFormat <string>

Exibe a data e a hora no formato UNIX. Para obter uma lista dos especificadores de formato, consulte a seção Observações.

Quando você usar o parâmetro UFormat, o Windows PowerShell irá recuperar somente as propriedades do objeto DateTime necessárias para exibir a data no formato especificado por você. Dessa forma, algumas das propriedades e métodos dos objetos DateTime podem não estar disponíveis.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Year <int>

Especifica o ano exibido. Digite um valor entre 1 e 9999. Esse valor será exibido no lugar do ano atual.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

Nenhum

Você não pode canalizar a entrada para este cmdlet.

Saídas

System.DateTime ou System.String

Quando você usar o parâmetro Format ou UFormat, o objeto de saída será System.String.

Observações

Por padrão, a data-hora é exibida em formatos de data e hora por extenso da localidade do sistema.

Quando você canaliza uma data para cmdlets que esperam entrada de cadeia de caracteres, como Add-Content, o Windows PowerShell converte o objeto DateTime em uma cadeia de caracteres antes de adicioná-lo ao arquivo. O formato ToString() padrão é data abreviada e hora por extenso. Para especificar um formato alternativo, use os parâmetros Format ou UFormat de Get-Date.

Valores Uformat:

Os valores a seguir pertencem ao parâmetro UFormat. O formato do comando é:

get-date -uformat %<valor>

Por exemplo,

get-date -uformat %d

Data-Hora:

Data e hora – completa

(padrão) (Sexta-feira, 16 de junho de 2006 10:31:27)

c Data e hora - abreviada (Sex, 16 de junho, 10:31:27 2006)

Data:

D Data no formato dd/mm/aa (14/06/06)

x Data no formato padrão local (12/09/07 para português, Brasil)

Ano:

C Século (20 para 2006)

Y Ano no formato de quatro dígitos (2006)

y Ano no formato de dois dígitos (06)

G Mesmo que "Y"

g Mesmo que "y"

Mês:

b Nome do mês – abreviado (Jan)

B Nome do mês – completo (Janeiro)

h Mesmo que "h"

m Month number (06)

Semana:

W Semana do ano (00-52)

V Semana do ano (01-53)

U Mesmo que "W"

Dia:

a Dia da semana – nome abreviado (Mon)

A Dia da semana – nome completo (Segunda-feira)

u Dia da semana – número (Segunda-feira = 1)

d Dia do mês – 2 dígitos (05)

e Dia do mês – dígito precedido por um espaço ( 5)

j Dia do ano – (1-366)

w Mesmo que "u"

Horário:

p AM ou PM

r Hora no formato de 12 horas (09:15:36 AM)

R Hora no formato de 24 horas – sem segundos (17:45)

T Hora no formato de 24 horas (17:45:52)

X Mesmo que "T"

Z Diferença de fuso horário de UTC (Tempo Universal Coordenado) (-07)

Hora:

H Hora no formato de 24 horas (17)

I Hora no formato de 12 horas (05)

k Mesmo que "H"

l Mesmo que "I" (I maiúsculo I = L minúsculo)

Minutos e segundos:

M Minutes (35)

S Segundos (05)

s Segundos transcorridos desde 1º de janeiro de 1970 00:00:00 (1150451174,95705)

Caracteres especiais:

n caractere de nova linha (\n)

t caractere de Tab (\t)

Exemplo 1

C:\PS>get-date -DisplayHint date

Tuesday, June 13, 2006

Descrição
-----------
Esse comando recupera um objeto DateTime, mas exibe somente a data. Ele usa o parâmetro DisplayHint para indicar que somente a data será exibida.

Exemplo 2

C:\PS>get-date -format g

6/13/2006 12:43 PM

Descrição
-----------
Esse comando recupera a data/hora atual e a formata em uma data abreviada e uma hora abreviada. Ele usa o especificador de formato "g" .NET Framework (Geral [data e hora abreviadas]) para especificar o formato.

Exemplo 3

C:\PS>get-date -uformat "%Y / %m / %d / %A / %Z"

2006 / 06 / 13 / Tuesday / -07

Descrição
-----------
Esse comando recupera a data/hora atual e a formata como especificado pelo comando. Nesse caso, o formato inclui o ano completo (%Y), o mês numérico em dois dígitos (%m), a data (%d), o dia completo da semana (%A) e a diferença de UTC ("Zulu").

Exemplo 4

C:\PS>(get-date -year 2000 -month 12 -day 31).dayofyear

366

Descrição
-----------
Este comando exibe o dia do ano para a data atual. Por exemplo, 31 de dezembro é o 365º dia de 2006, mas é o 366º dia de 2000.

Exemplo 5

C:\PS>$a = get-date

C:\PS> $a.IsDaylightSavingTime()

True

Descrição
-----------
Esses comandos o avisam se a data e a hora atuais estão ajustadas para o horário de verão no local atual. 

O primeiro comando cria uma variável denominada $a e designa o objeto recuperado pelo Get-Date à variável $a. Em seguida, ele usa o método IsDaylightSavingTime no objeto em $a.

Para ver as propriedades e métodos do objeto DateTime, digite:
 "get-date | get-member".

Exemplo 6

C:\PS>$a = get-date

C:\PS> $a.ToUniversalTime()

Tuesday, June 13, 2006 8:09:19 PM

Descrição
-----------
Esses comandos convertem a data e a hora atuais para o horário de UTC.

O primeiro comando cria uma variável denominada $a e designa o objeto recuperado pelo Get-Date à variável $a. Em seguida, ele usa o método ToUniversalTime no objeto em $a.

Exemplo 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

Descrição
-----------
O WMI (Instrumentação de Gerenciamento do Windows) usa um objeto date-time diferente do objeto date-time do .NET Framework que o Get-Date retorna. Para usar as informações de date-time do WMI em um comando com informações de date-time do Get-Date, você precisa usar o método ConvertToDateTime para converter os objetos CIM_DATETIME do WMI para objetos DateTime do .NET Framework.

Os comandos desse exemplo exibem o nome e a idade do BIOS em um computador remoto, Server01. 

O primeiro comando usa o cmdlet Get-WmiObject para obter uma instância da classeWin32_BIOS no Server01 e a armazena na variável $a.

O segundo comando usa o operador de pipeline (|) para enviar o objeto WMI armazenado em $a para o cmdlet Format-List. O parâmetro Property de Format-List é usado para especificar duas propriedades a serem exibidas na lista, "Name" e "BIOS Age". A propriedade "BIOS Age" é especificada em uma tabela de hash. A tabela inclui a chave Label, que especifica o nome da propriedade, e a chave Expression, a qual contém a expressão que calcula a idade do BIOS. A expressão usa o método ConvertToDateTime para converter cada instância de ReleaseDate em um objeto DateTime do .NET Framework. Em seguida, o valor é subtraído do valor do cmdlet Get-Date, o qual, sem parâmetros, obtém a data atual.

O caractere de crase (`) é o caractere de continuação de linha no Windows PowerShell.

Exemplo 8

C:\PS>get-date

Tuesday, June 13, 2006 12:43:42 PM

Descrição
-----------
Esse comando obtém um objeto DateTime e exibe a data e a hora atuais nos formatos de data e hora por extenso da localidade do sistema, mesmo que você tenha digitado "get-date -formate F".

Exemplo 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

Descrição
-----------
Esses comandos demonstram como usar Get-Date com Add-Content e outros cmdlets que convertem o objeto DateTime gerado pelo Get-Date em uma cadeia de caracteres.

O primeiro comando mostra que a exibição padrão de um comando "get-date" está no formato de data e hora por extenso.

O segundo comando mostra que a exibição padrão do método ToString () do objeto DateTime está no formato de data e hora abreviadas.

O terceiro comando usa um operador de pipeline para enviar o objeto DateTime para o cmdlet Add-Content que adiciona o conteúdo ao arquivo Test.txt. Como o Add-Content usa o método ToString () do objeto DateTime, a data adicionada está no formato de data e hora abreviadas.

O quarto comando usa o parâmetro Format de Get-Date para especificar o formato. Quando você usa os parâmetros Format ou UFormat, Get-Date gera uma cadeia de caracteres, não um objeto DateTime. Em seguida, quando você envia a cadeia de caracteres ao Add-Content, ele adiciona o arquivo Test.txt sem alterá-lo.

Consulte também

Conceitos

Set-Date
New-TimeSpan

Compartilhar via