date - exibe ou define a data e hora do sistema
SINTAXE
date [OPÇÃO]... [+FORMATO]
date [-u|--utc|--universal] [MMDDhhmm[[CC]YY][.ss]]
DESCRIÇÃO
Exibe a data e hora no FORMATO especificado. Com -s, ou com [MMDDhhmm[[CC]YY][.ss]], define a data e hora.
Os argumentos obrigatórios para opções longas também são obrigatórios para opções curtas.
-d, --date=STRING
exibe a hora descrita por STRING, e não 'agora'
--debug
anota a data analisada e alerta sobre usos questionáveis para stderr
-f, --file=DATEFILE
semelhante a --date; uma vez para cada linha de DATEFILE
-I[FMT], --iso-8601[=FMT]
exibe a data/hora no formato ISO 8601. FMT='date' para data apenas (o padrão), 'hours',
'minutes', 'seconds' ou 'ns' para data e hora com a precisão indicada. Exemplo:
200608-14T02:34:56-06:00
--resolution
exibe a resolução disponível de timestamps. Exemplo: 0.000000001
-R, --rfc-email
exibe a data e hora no formato RFC 5322. Exemplo: Mon, 14 Aug 2006 02:34:56 -0600
--rfc-3339=FMT
exibe a data/hora no formato RFC 3339. FMT='date', 'seconds' ou 'ns' para data e hora com a
precisão indicada. Exemplo: 2006-08-14 02:34:56-06:00
-r, --reference=ARQUIVO
exibe o tempo da última modificação do ARQUIVO
-s, --set=STRING
define a hora descrita por STRING
-u, --utc, --universal
exibe ou define o Tempo Universal Coordenado (UTC)
--help exibe esta ajuda e sai
--version
exibe informações da versão e sai
Todas as opções que especificam a data a ser exibida são mutuamente exclusivas. Ou seja: --date, --file, --reference, --resolution.
FORMATO controla a saída. As sequências interpretadas são:
%% um literal %
%a nome abreviado do dia da semana da localidade (por exemplo, Sun)
%A nome completo do dia da semana da localidade (por exemplo, Sunday)
%b nome abreviado do mês da localidade (por exemplo, Jan)
%B nome completo do mês da localidade (por exemplo, January)
%c data e hora da localidade (por exemplo, Thu Mar 3 23:05:25 2005)
%C século; como %Y, exceto que omite os dois últimos dígitos (por exemplo, 20)
%d dia do mês (por exemplo, 01)
%D data (ambígua); igual a %m/%d/%y
%e dia do mês, preenchido com espaços; igual a %_d
%F data completa; como %+4Y-%m-%d
%g dois últimos dígitos do ano do número da semana ISO (ambíguo; 00-99); veja %G
%G ano do número da semana ISO; normalmente útil apenas com %V
%h igual a %b
%H hora (00..23)
%I hora (01..12)
%j dia do ano (001..366)
%k hora, preenchida com espaços ( 0..23); igual a %_H
%l hora, preenchida com espaços ( 1..12); igual a %_I
%m mês (01..12)
%M minuto (00..59)
%n uma nova linha
%N nanossegundos (000000000..999999999)
%p equivalente da localidade para AM ou PM; em branco se desconhecido
%P como %p, mas em letras minúsculas
%q trimestre do ano (1..4)
%r hora do relógio de 12 horas da localidade (por exemplo, 11:11:04 PM)
%R hora e minuto de 24 horas; igual a %H:%M
%s segundos desde a Época (1970-01-01 00:00 UTC)
%S segundo (00..60)
%t uma tabulação
%T hora; igual a %H:%M:%S
%u dia da semana (1..7); 1 é segunda-feira
%U número da semana do ano, com domingo como o primeiro dia da semana (00..53)
%V número da semana ISO, com segunda-feira como o primeiro dia da semana (01..53)
%w dia da semana (0..6); 0 é domingo
%W número da semana do ano, com segunda-feira como o primeiro dia da semana (00..53)
%x data da localidade (pode ser ambígua; por exemplo, 12/31/99)
%X representação de hora da localidade (por exemplo, 23:13:48)
%y dois últimos dígitos do ano (ambíguo; 00..99)
%Y ano
%z fuso horário numérico +hhmm (por exemplo, -0400)
%:z fuso horário numérico +hh:mm (por exemplo, -04:00)
%::z fuso horário numérico +hh:mm:ss (por exemplo, -04:00:00)
%:::z fuso horário numérico com : até a precisão necessária (por exemplo, -04, +05:30)
%Z abreviação alfabética do fuso horário (por exemplo, EDT)
Por padrão, date preenche campos numéricos com zeros. Os seguintes sinalizadores opcionais podem seguir '%':
- (hífen) não preencher o campo
_ (sublinhado) preencher com espaços
0 (zero) preencher com zeros
+ preencher com zeros e colocar '+' antes dos anos futuros com >4 dígitos
^ usar maiúsculas, se possível
# usar maiúsculas ou minúsculas alternadas, se possível
Após qualquer sinalizador, vem uma largura de campo opcional, como um número decimal; em seguida, um modificador opcional, que é E para usar as representações alternativas da localidade, se disponíveis, ou O para usar os símbolos numéricos alternativos da localidade, se disponíveis.
EXEMPLOS
Converter segundos desde a Época (1970-01-01 UTC) para uma data
$ date --date='@2147483647'
Mostrar a hora na costa oeste dos EUA (use tzselect(1) para encontrar TZ)
$ TZ='America/Los_Angeles' date
Mostrar a hora local para as 9h da próxima sexta-feira na costa oeste dos EUA
$ date --date='TZ="America/Los_Angeles" 09:00 next Fri'
STRING DE DATA
A opção --date=STRING é uma string de data legível por humanos, de formato livre, como "Sun, 29 Feb 2004 1621:42 -0800" ou "2004-02-29 16:21:42" ou até mesmo "next Thursday". Uma string de data pode conter itens que indicam data do calendário, hora do dia, fuso horário, dia da semana, tempo relativo, data relativa e números. Uma string vazia indica o início do dia. O formato da string de data é mais complexo do que pode ser facilmente documentado aqui, mas está totalmente descrito na documentação do info.
AUTOR
Escrito por David MacKenzie.
RELATANDO BUGS
Ajuda online do GNU coreutils: [https://www.gnu.org/software/coreutils/] Relate quaisquer bugs de tradução para [https://translationproject.org/team/]
VEJA TAMBÉM
Documentação completa [https://www.gnu.org/software/coreutils/date] ou disponível localmente via: info '(coreutils) date invocation'
Empacotado por Debian (9.7-3) Copyright © 2025 Free Software Foundation, Inc. Licença GPLv3+: GNU GPL versão 3 ou posterior [https://gnu.org/licenses/gpl.html]. Este é um software livre: você é livre para modificá-lo e redistribuí-lo. Não há GARANTIA, na medida permitida por lei.