Get-Date (Português)
obtém a data e hora actuais.
Sintaxe
Descrição
Get-Date
cmdlet obtém um objeto DateTime que representa a data atual ou uma data em que youspecify. Get-Date
pode formatar a data e a hora em vários formatos.NET e UNIX. Você pode usarGet-Date
para gerar uma cadeia de caracteres de data ou hora, e então enviar a cadeia para outros cmdlets ou programas.,
Get-Date
usa as configurações de cultura do computador para determinar como a saída é formatada. Para ver as configurações do seu computador, use (Get-Culture).DateTimeFormat
.
exemplos
exemplo 1: Obter a data e hora actuais
neste exemplo, Get-Date
mostra a data e hora actuais do sistema. A produção encontra-se em formatos de longa data e de longa duração.
Exemplo 2: Obter elementos de a data e hora actuais
Este exemplo mostra como usar Get-Date
para obter a data ou a hora elemento., O parâmetro usa a data, hora ou DateTime dos argumentos.
Get-Date
usa o parâmetro DisplayHint com o argumento da data para obter apenas a data.
Exemplo 3: Obter a data e a hora com um .NET especificador de formato
neste exemplo, um .NET especificador de formato é utilizado para personalizar a saída do”s formato. A saída é um objeto Astral.
Get-Date
utiliza o parâmetro de formato para especificar vários especificadores de formato.
A .,div id=”cbd664877c”>
MM
dd
yyyy
HH:mm
K
For more information about .,Especificadores de formato líquido, seecustom data e hora formatação strings.
exemplo 4: Obter a data e a hora com um especificador de UFormat
neste exemplo, vários especificadores de formato UFormat são usados para personalizar o formato de saída ” S.A saída é um objeto de cadeia de caracteres.
Get-Date
usa o parâmetro UFormat para especificar vários especificadores de formato.,f the week – full name
%m
%d
%Y
%R
%Z
For a list of valid UFormat format specifiers, see the Notes section.,
exemplo 5: Obter uma data ” s dia do ano
neste exemplo, uma propriedade é usada para obter o dia numérico do ano.o calendário gregoriano tem 365 dias, exceto para os anos bissextos que têm 366 dias. Por exemplo, December 31, 2020 é o dia 366.
Get-Date
utiliza três parâmetros para especificar a data: Ano, Mês e Dia. O comando é embrulhado com parêntesis para que o resultado seja avaliado pela propriedade do dia do ano.,
exemplo 6: Verifique se uma data é ajustada para a hora de Verão
este exemplo usa um método booleano para verificar se uma data é ajustada pela hora de Verão.
Uma variável, $DST
armazena o resultado de Get-Date
. $DST
utiliza o método IsDaylightSavingTime para testar se a data é ajustada para o horário de Verão.
exemplo 7: converter a hora actual para hora UTC
neste exemplo, a hora actual é convertida para hora UTC., O deslocamento UTC para o local do sistema é usado para converter o tempo. Uma tabela na seção Notas lista os especificadores uformatformat válidos.
Get-Date
usa o parâmetro UFormat com especificadores de formato para mostrar os dados e o tempo atuais do sistema. O especificador de formato %Z representa o deslocamento UTC de -07.
The $Time
variable stores the current system date and time. $Time
usa o método do ToUniversalTime()para converter o tempo baseado no deslocamento UTC do computador.,
exemplo 8: criar um timestamp
neste exemplo, um especificador de formato cria um objecto de texto timestamp para um nome de diretório. O tempo inclui a data, hora e deslocamento UTC.
The$timestamp
variable stores the results of aGet-Date
command. Get-Date
usa o Formatparameter com o formato específico de minúsculas o
para criar um objeto de cadeia de timestamp. Theobject is sent down the pipeline to ForEach-Object
., Um ScriptBlock contém o $_
variable that represents the current pipeline object. A cadeia timestamp é delimitada por colões que são substituídos por períodos.
New-Item
usa o parâmetro Path para indicar a localização de uma nova pasta. A localização inclui a variável $timestamp
como nome do directório. O parâmetro tipo especifica que adiretório é criado.
exemplo 9: converter um timestamp Unix
este exemplo converte um tempo Unix (representado pelo número de segundos desde 1970-01-01 0: 00: 00) para a DateTime.,
Exemplo 10: Retorna um valor de data é interpretado como UTC
Este exemplo mostra como interpretar um valor de data como seu UTC equivalente. Para o exemplo, thisachine é definido para o tempo padrão do Pacífico. Por omissão, Get-Date
devolve os valores da thattimezona. Use o parâmetro AsUTC para converter o valor para o tempo equivalente UTC.
parâmetros
converte o valor da data para a hora equivalente em UTC.
Este parâmetro foi introduzido em PowerShell 7.1.,
Tipo: | SwitchParameter |
Cargo: | Nome |
valor Padrão: | None |
Aceita a entrada de pipeline: | False |
Aceita caracteres curinga: | False |
Especifica a data e a hora. A hora é opcional e se não for indicada, retorna 00: 00: 00.
indique a data e a hora num formato que seja padrão para a localização do sistema.,
For example, in US English:
Get-Date -Date "6/25/2019 12:30:22"
returns Tuesday, June 25, 2019 12:30:22
Type: | DateTime |
Aliases: | LastWriteTime |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Specifies the day of the month that is displayed. Enter a value from 1 to 31.,
Se o valor especificado for maior do que o número de dias em um mês, PowerShell adiciona o número de dias ao mês. Por exemplo, Get-Date -Month 2 -Day 31
exibe 3 de Março, Não 31 de fevereiro.,
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Determines which elements of the date and time are displayed.,
Tipo: | DisplayHintType |
valores Aceitos: | Data, Hora, DateTime |
Cargo: | Nome |
valor Padrão: | None |
Aceita a entrada de pipeline: | False |
Aceita caracteres curinga: | False |
Exibe a data e a hora na Microsoft .,Formato de Framework net indicado pelo especificador de formato.O parâmetro formato produz um objecto de texto.
para uma lista de especificadores de formato. net disponíveis, seecustom data e hora strings de formato.
When the Format parameter is used, Get-Date
only gets the DateTime object”s propertiesnecessary to display the date. Como resultado, algumas das propriedades e métodos de DateTimeobjects podem não estar disponíveis.
começando em PowerShell 5.0, você pode usar os seguintes formatos adicionais como valores para o parâmetro format.
-
Filedato., Um ficheiro ou uma representação amigável da data actual na hora local. The formatis
yyyyMMdd
(case-sensitive, using a 4-digit year, 2-digit month, and 2-digit day). Por exemplo: 20190627. -
FileDateUniversal. Um ficheiro ou uma representação amigável da data actual na universaltime (UTC). O formato é
yyyyMMddZ
(case-sensitive, using a 4-digit year, 2-digit month,2-digit day, and the letterZ
as the UTC indicator). Por exemplo: 20190627Z. -
FileDateTime., Um ficheiro ou uma representação amigável da data e hora actuais no formato local, em 24 horas. O formato é
yyyyMMddTHHmmssffff
(case-sensitive, using a 4-digityear, 2-digit month, 2-digit day, the letterT
as a time separator, 2-digityear hour, 2-digitminute, 2-digit second, and 4-digit millisecond). Por exemplo: 20190627T0840107271. -
FileDateTimeUniversal. Um ficheiro ou uma representação amigável da data e hora actuais (UTC), em formato de 24 horas., O formato é
yyyyMMddTHHmmssffffZ
(case-sensitive,using a 4-digit year, 2-digit month, 2-digit day, the letterT
as a time separator, 2-digithour, 2-digit minute, 2-digit second, 4-digit millisecond, and the letterZ
as the UTCindicator). Por exemplo: 20190627T1540500718Z.,
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies the hour that is displayed. Enter a value from 0 to 23.,
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies the milliseconds in the date. Enter a value from 0 to 999.
This parameter was introduced in PowerShell 3.0.,
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies the minute that is displayed. Enter a value from 0 to 59.,
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies the month that is displayed. Enter a value from 1 to 12.,
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies the second that is displayed. Enter a value from 0 to 59.,
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Displays the date and time in UNIX format. The UFormat parameter outputs a string object.,
UFormat especificadores são precedidos por um sinal de porcentagem (%
), por exemplo, %m
%d
e %Y
. A Notessecção contém uma tabela de especificadores uformat válidos.
When the UFormat parameter is used, Get-Date
only gets the DateTime object”s propertiesnecessary to display the date. Como resultado, algumas das propriedades e métodos de DateTimeobjects podem não estar disponíveis.,
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Date and time represented in seconds since January 1, 1970, 0:00:00.
This parameter was introduced in PowerShell 7.1.,
Type: | Int64 |
Aliases: | UnixTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies the year that is displayed. Enter a value from 1 to 9999.,
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
Pipeline input
Get-Date
accepts pipeline input. For example, Get-ChildItem | Get-Date
.
Outputs
System.DateTime or System.,String
Get-Date
devolve um objecto DateTime, excepto quando os parâmetros do formato e do UFormat são utilizados. Os parâmetros do formato ou UFormat retornam objetos de texto.
When a DateTime object is sent down the pipeline to a cmdlet such as Add-Content
that expectstring input, PowerShell converts the object to a String object.
o método (Get-Date).ToString()
converte um objecto DateTime um objecto de cadeia de caracteres.
para exibir as propriedades e métodos de um objeto, envie o objeto para baixo do pipeline para Get-Member
.,Por exemplo, Get-Date | Get-Member
.
notas
DateTime objects are in long-date and long-time formats for the system locale.
O válido UFormat especificadores são apresentados na tabela a seguir:
- ForEach-Object
- Get-Cultura
- Get-member
- New-Item
- Novo-TimeSpan
- Set-Date