

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
<a name="FORMAT_strings"></a>

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<br />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 <br />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<br />07<br />jul<br />Julho | 
| O | Deslocamento de zona localizado em relação ao UTC | GMT \+8<br />GMT\+ 8:00<br />UTC- 08:00 | 
| Q/q  | Trimestre do ano, apresentado como um número (1 a 4) ou texto | 3<br />03<br />Q3<br />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<br />Z<br />08:30 | 
| x | Deslocamento de zona em relação ao UTC (offset-X) | \+0000<br />-08<br />-0830<br />- 08:30<br />-083015<br />- 08:30:15 | 
| X | Deslocamento de zona em relação ao UTC; onde Z é zero | Z<br />-08<br />-0830<br />- 08:30<br />-083015<br />- 08:30:15 | 
| y | Ano, apresentado como um ano | 2020<br />20 | 
| z | Nome do fuso horário, apresentado como texto | Hora Oficial do Pacífico<br />PST | 
| Z | Deslocamento de zona em relação ao UTC (offset-Z) | \+0000<br />-0800<br />- 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 independente
  + 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).