Padrões de datetime

Aplica-se a: Databricks SQL Databricks Runtime

Há vários cenários comuns para uso de data/hora no Azure Databricks:

• As fontes de dados CSV e JSON usam a cadeia de caracteres padrão para analisar e formatar conteúdo datetime.
• Funções de data/hora relacionadas à conversão STRING de e DATE para ou TIMESTAMP. Por exemplo:
  • unix_timestamp
  • date_format
  • to_unix_timestamp
  • from_unixtime
  • to_char
  • até a data
  • to_timestamp
  • to_varchar
  • from_utc_timestamp
  • to_utc_timestamp

Tabela de padrões

O Azure Databricks usa letras de padrão na tabela a seguir para análise e formatação de data e hora.

Símbolo	Significado	Apresentação	Exemplos
G	era	enviar SMS	AD; Anno Domini
y	ano	ano	2020; 20
D	dia-do-ano	número(3)	189
M/L	mês-do-ano	mês	7; 07; Jul; Julho
d	dia-do-mês	número(3)	28
P/q	Trimestre-de-Ano	número/texto	3; 03; 3º; 3º trimestre
E	dia-da-semana	enviar SMS	Ter; Terça-feira
F	alinhado dia da semana no mês	número(1)	3
um	am-pm-de-dia	AM-PM	da tarde
h	hora-relógio-da-am-pm (1-12)	número(2)	12
K	Hora-da-AM-PM (0-11)	número(2)	0
k	Hora-relógio do dia (1-24)	número(2)	0
H	Hora-do-dia (0-23)	número(2)	0
m	minuto-de-hora	número(2)	30
s	segundo-de-minuto	número(2)	55
S	fração de segundo	fração	978
V	ID de fuso horário	identificação da zona	América/Los_Angeles; Z; -08:30
z	nome do fuso horário	nome-da-zona	Hora Padrão do Pacífico; PST
O	deslocamento de fuso horário localizado	compensação-O	GMT+8; GMT+08:00; UTC-08:00;
X	deslocamento de zona 'Z' para zero	compensação-X	Z; -08; -0830; -08:30; -083015; -08:30:15;
x	deslocamento de fuso horário	compensação-x	+0000; -08; -0830; -08:30; -083015; -08:30:15;
Z	deslocamento de fuso horário	compensação-Z	+0000; -0800; -08:00;
'	Escape para texto	delimitador
''	citação única	literal	'
[	início de secção opcional
]	fim de secção opcional

A contagem de letras padrão determina o formato.

• Texto: O estilo do texto é determinado com base no número de letras padrão usadas. Menos de 4 letras padrão usarão a forma de texto curto, normalmente uma abreviação, por exemplo, segunda-feira do dia da semana pode produzir "Seg". Exatamente 4 letras padrão usarão o formulário de texto completo, normalmente a descrição completa, por exemplo, segunda-feira do dia da semana pode produzir "segunda-feira". 5 ou mais letras falharão.

• Número(n): O n aqui representa a contagem máxima de letras que este tipo de padrão datetime pode ser usado. Se a contagem de letras for uma, então o valor é gerado usando o número mínimo de dígitos e sem preenchimento. Caso contrário, a contagem de dígitos é usada como a largura do campo de saída, com o valor zero-acolchoado conforme necessário.

• Número/Texto: Se a contagem de letras padrão for 3 ou superior, use as regras de texto acima. Caso contrário, use as regras de número acima.

• Fração: Use um ou mais (até 9) caracteres contíguos 'S' , por exemplo, SSSSSSpara analisar e formatar fração de segundo. Para a análise, o comprimento da fração aceitável pode ser [1, o número de «S» contíguos]. Para a formatação, o comprimento da fração seria preenchido com zeros até atingir o número de «S» contíguos. O Azure Databricks suporta datetime de precisão de micro de segundo, que tem até 6 dígitos significativos, mas pode analisar nano de segundo com a parte excedida truncada.

• Ano: A contagem de letras determina a largura mínima do campo abaixo da qual o preenchimento é usado. Se a contagem de letras for duas, então uma forma reduzida de dois dígitos é usada. Para impressão, isso gera os dois dígitos mais à direita. Para a análise, esta análise utilizará o valor de base de 2000, resultando num ano dentro do intervalo de 2000 a 2099, inclusive. Se a contagem de letras for inferior a quatro (mas não duas), então o sinal só é produzido para anos negativos. Caso contrário, o sinal é de saída se a largura da almofada for excedida quando 'G' não estiver presente. 7 ou mais letras falharão.

• Mês: Segue a regra do Número/Texto. A forma de texto depende de letras - 'M' denota a forma "padrão" e 'L' é para a forma "independente". Estas duas formas são diferentes apenas em algumas línguas. Por exemplo, em russo, 'Июль' é a forma independente de julho, e 'Июля' é a forma padrão. Aqui estão exemplos de todas as letras de padrão suportadas:

  • 'M' ou 'L': Número do mês num ano a partir de 1. Não há diferença entre 'M' e 'L'. Mês de 1 a 9 são impressos sem preenchimento.

    > SELECT date_format(date '1970-01-01', 'M');
      1
    
    > SELECT date_format(date '1970-12-01', 'L');
      12
    

  • 'MM' ou 'LL': Número do mês num ano a partir de 1. O preenchimento zero é adicionado para os meses 1-9.

    > SELECT date_format(date '1970-1-01', 'LL');
      01
    
    > SELECT date_format(date '1970-09-01', 'MM');
      09
    

  • 'MMM': Breve representação textual no formulário-tipo. O padrão de mês deve fazer parte de um padrão de data, não apenas de um mês autônomo, exceto em localidades onde não há diferença entre formulários comuns e autônomos, como no inglês.

    > SELECT date_format(date '1970-01-01', 'd MMM');
      1 Jan
    
    -- Passing a format pattern to to_csv()
    > SELECT to_csv(named_struct('date', date '1970-01-01'), map('dateFormat', 'dd MMM', 'locale', 'RU'));
      01 янв.
    

  • 'MMMM': Representação textual completa do mês no formulário-tipo. É usado para analisar/formatar meses como parte de datas/carimbos de data/hora.

    > SELECT date_format(date '1970-01-01', 'd MMMM');
      1 January
    
    -- Passing a format pttern to to_csv()
    > SELECT to_csv(named_struct('date', date '1970-01-01'), map('dateFormat', 'd MMMM', 'locale', 'RU'));
      1 января
    

• am-pm: Isso produz o am-pm-of-day. A contagem de letras padrão deve ser 1.

• ID da Zona(V): Isso gera a exibição da ID do fuso horário. A contagem de letras padrão deve ser 2.

• Nomes de zona(z): Isso gera o nome textual de exibição do ID de fuso horário. Se a contagem de letras é uma, duas ou três, então o nome curto é saída. Se a contagem de letras for quatro, então o nome completo é saída. Cinco ou mais letras falharão.

• Deslocamento X e x: formata o deslocamento com base no número de letras do padrão. Uma letra produz apenas a hora, como '+01', a menos que o minuto seja diferente de zero; neste caso, o minuto também é incluído, como '+0130'. Duas letras produzem a hora e o minuto, sem dois pontos, como '+0130'. Três caracteres apresentam a hora e o minuto, separados por dois pontos, como '+01:30'. Quatro dígitos produzem a hora e o minuto e um segundo opcional, sem dois-pontos, como '+013015'. Cinco letras exibem a hora, o minuto e o segundo opcional com dois-pontos, como '+01:30:15'. Seis ou mais letras falharão. A letra padrão 'X' (maiúsculas) irá exibir 'Z' quando o deslocamento a ser exibido for zero, enquanto a letra padrão 'x' (minúscula) irá exibir '+00', '+0000' ou '+00:00'.

• Deslocamento O: Este formata o deslocamento localizado de acordo com o número de letras do padrão. Uma letra apresenta a forma curta do fuso horário localizado, que é o texto formatado como 'GMT', com hora sem zero à esquerda, minuto opcional de 2 dígitos e segundo se não forem zero, e um dois-pontos, por exemplo, 'GMT+8'. Quatro caracteres produzem a forma completa, que corresponde a um texto de deslocamento localizado, como 'GMT, com um campo de hora e minuto com 2 dígitos, um campo de segundos opcional se não for zero, e delimitado por dois pontos, por exemplo 'GMT+08:00'. Qualquer outra contagem de letras falhará.

• Deslocamento Z: Formata o deslocamento com base no número de letras padrão. Um, dois ou três caracteres apresentam a hora e o minuto, sem dois pontos, como '+0130'. A saída é '+0000' quando o deslocamento é zero. Quatro letras produzem a forma completa de deslocamento localizado, equivalente a quatro letras de Offset-O. A saída é o texto de deslocamento localizado correspondente se o deslocamento for zero. Cinco letras produzem a hora, minuto, com segundo opcional se diferente de zero, com dois pontos. Retorna 'Z' se o deslocamento for zero. Seis ou mais letras falharão.

• Início e fim da seção opcional: Use [] para definir uma seção opcional e talvez aninhada. Durante a formatação, todos os dados válidos são produzidos, mesmo que estejam na seção opcional. Durante a análise, toda a seção pode estar faltando na cadeia de caracteres analisada. Uma seção opcional é iniciada e [ terminada usando ] (ou no final do padrão).

• Os símbolos de «E», «F», «q» e «Q» só podem ser utilizados para a formatação de data e hora, por exemplo, date_format. Eles não são permitidos usados para análise de data/hora, por exemplo. to_timestamp

Artigos relacionados

• date_format Função
• from_unixtime Função
• from_utc_timestamp Função
• to_char Função
• to_date Função
• to_timestamp Função
• to_utc_timestamp Função
• to_unix_timestamp Função
• to_varchar Função
• unix_timestamp Função