As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Strings de formato datetime
Você pode usar padrões de data e hora nos seguintes cenários comuns:
-
Ao trabalhar com fontes de dados CSV e JSON para analisar e formatar conteúdo de data e hora
-
Ao converter entre tipos de string e tipos de data ou timestamp usando funções como:
-
unix_timestamp
-
date_format
-
carimbo de data/hora to_unix_
-
from_unixtime
-
to_date
-
to_timestamp
-
from_utc_timestamp
-
to_utc_timestamp
-
Use as letras padrão na tabela a seguir para análise e formatação de data e hora.
| Datepart ou timepart | Significado | Exemplos |
|---|---|---|
| a | AM ou PM do dia, apresentado como am-pm | PM |
| D | Dia do ano, apresentado como um número de 3 dígitos |
189 |
| d | Dia do mês, apresentado como um número de 2 dígitos | 28 |
| E | Dia da semana, apresentado como texto |
Ter Terça-feira |
| F | Dia da semana alinhado no mês, apresentado como um número de 1 dígito | 3 |
| G | Indicador de era, apresentado como texto |
AD Anno Domini |
| h | Horário da manhã ou da tarde, apresentado como um número de 2 dígitos | 12 |
| H | Hora do dia, apresentada como um número de 2 dígitos de 0 a 23 | 0 |
| k | Hora do dia, apresentada como um número de 2 dígitos de 1 a 24 | 1 |
| K | Hora da manhã ou da tarde, apresentada como um número de 2 dígitos de 0 a 11 | 0 |
| m | Minuto de hora, apresentado como um número de 2 dígitos | 30 |
| M/L | Mês do ano, apresentado como um mês |
7 07 jul Julho |
| O | Deslocamento de zona localizado em relação ao UTC |
GMT +8 GMT+ 8:00 UTC- 08:00 |
| Q/q | Trimestre do ano, apresentado como um número (1 a 4) ou texto |
3 03 Q3 3º trimestre |
| s | Segundo do minuto, apresentado como um número de 2 dígitos | 55 |
| S | Fração de segundo, apresentada como uma fração | 978 |
| V | Identificador de fuso horário, apresentado como uma identificação de zona |
America/Los_Angeles Z 08:30 |
| x | Deslocamento de zona em relação ao UTC (offset-X) |
+0000 -08 -0830 - 08:30 -083015 - 08:30:15 |
| X | Deslocamento de zona em relação ao UTC; onde Z é zero |
Z -08 -0830 - 08:30 -083015 - 08:30:15 |
| y | Ano, apresentado como um ano |
2020 20 |
| z | Nome do fuso horário, apresentado como texto |
Hora Oficial do Pacífico PST |
| Z | Deslocamento de zona em relação ao UTC (offset-Z) |
+0000 -0800 - 08:00 |
| ' | Escape para texto, apresentado como um delimitador | N/D |
| '' | Citação única, apresentada como literal | ' |
| [ | Início da seção opcional | N/D |
| ] | Fim de seção opcional | N/D |
O número de letras padrão determina o tipo de formato:
Formato de texto
-
Use de 1 a 3 letras para a forma abreviada (por exemplo, “Mon” para segunda-feira)
-
Use exatamente 4 letras para o formulário completo (por exemplo, “segunda-feira”)
-
Não use 5 ou mais letras - isso causará um erro
Formato numérico (n)
-
O valor n representa o número máximo de letras permitido
-
Para padrões de letra única:
-
A saída usa dígitos mínimos sem preenchimento
-
-
Para vários padrões de letras:
-
A saída é preenchida com zeros para corresponder à largura da contagem de letras
-
-
Ao analisar, a entrada deve conter o número exato de dígitos
Formato de número/texto
-
Para 3 ou mais letras, siga as regras de formato de texto
-
Para menos letras, siga as regras de formato numérico
Formato de fração
-
Use de 1 a 9 caracteres 'S' (por exemplo, SSSSSS)
-
Para análise:
-
Aceite frações entre 1 e o número de caracteres S
-
-
Para formatação:
-
Almofada com zeros para corresponder ao número de caracteres S
-
-
Suporta até 6 dígitos para precisão de microssegundos
-
Pode analisar nanossegundos, mas trunca dígitos extras
Formato do ano
-
A contagem de letras define a largura mínima do campo para preenchimento
-
Para duas letras:
-
Imprime os dois últimos dígitos
-
Analisa anos entre 2000 e 2099
-
-
Por menos de quatro letras (exceto duas):
-
Mostra o sinal apenas para anos negativos
-
-
Não use 7 ou mais letras - isso causará um erro
Formato do mês
-
Use 'M' para o formulário padrão ou 'L' para o formulário autônomo
-
Único 'M' ou 'L':
-
Mostra os números dos meses de 1 a 12 sem preenchimento
-
-
'MM' ou 'LL':
-
Mostra os números dos meses de 01 a 12 com preenchimento
-
-
'MMM':
-
Mostra o nome abreviado do mês no formato padrão
-
Deve fazer parte de um padrão de data completo
-
-
'LLL':
-
Mostra o nome abreviado do mês em formato autônomo
-
Use para formatação somente por mês
-
-
'MMMM':
-
Mostra o nome completo do mês no formato padrão
-
Use para datas e carimbos de data e hora
-
-
'LLLL':
-
Mostra o nome completo do mês em formato independente
-
Use para formatação somente por mês
-
Formatos de fuso horário
-
am-pm: use apenas 1 letra
-
ID de zona (V): use apenas 2 letras
-
Nomes de zonas (z):
-
1-3 letras: mostra o nome curto
-
4 letras: mostra o nome completo
-
Não use 5 ou mais letras
-
Formatos de offset
-
X e x:
-
1 letra: Mostra a hora (+01) ou hora-minuto (+0130)
-
2 letras: Mostra hora-minuto sem dois pontos (+0130)
-
3 letras: mostra hora-minuto com dois pontos (+ 01:30)
-
4 letras: mostra hour-minute-second sem dois pontos (+013015)
-
5 letras: mostra hour-minute-second com dois pontos (+ 01:30:15)
-
X usa 'Z' para compensação zero
-
x usa '+00', '+0000' ou '+ 00:00 'para compensação zero
-
-
U:
-
1 letra: mostra a forma abreviada (GMT+8)
-
4 letras: Mostra o formulário completo (GMT+ 08:00)
-
-
Z:
-
1-3 letras: Mostra hora-minuto sem dois pontos (+0130)
-
4 letras: Mostra a forma localizada completa
-
5 letras: mostra hour-minute-second com dois pontos
-
Seções opcionais
-
Use colchetes [] para marcar conteúdo opcional
-
Você pode aninhar seções opcionais
-
Todos os dados válidos aparecem na saída
-
A entrada pode omitir seções opcionais inteiras
nota
Os símbolos 'E', 'F', 'q' e 'Q' funcionam somente para formatação de data e hora (como date_format). Não os use para análise de data e hora (como to_timestamp).