Padrões de datetime

Aplica-se a: SQL do Databricks Databricks Runtime

Há vários cenários comuns de uso de datetime no Azure Databricks:

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

Tabela de padrões

O Azure Databricks usa as letras do padrão na tabela a seguir para a análise e a formatação de data e carimbo de data/hora:

A contagem de letras padrão determina o formato.

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

• Number(n): o n aqui representa a contagem máxima de letras que esse tipo de padrão datetime pode ser usado. Se a contagem de letras for uma, o valor será de saída 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-preenchido conforme necessário.

• Número/texto: se a contagem de letras padrão for 3 ou maior, 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, SSSSSS para analisar e formatar a fração de segundo. Para análise, o comprimento aceitável da fração pode ser [1, o número do ‘S’ contíguo]. Para a formatação, o comprimento da fração seria preenchido para o número de ‘S’ contíguos. O Azure Databricks dá suporte a datetime de precisão de micro de segundo, que tem até 6 dígitos significativos, mas pode analisar o nano-of-second com uma parte excedente truncada.

• Ano: a contagem de letras determina a largura mínima do campo abaixo do qual o preenchimento é usado. Se a contagem de letras for duas, um formulário de dois dígitos reduzidos será usado. Para impressão, isso gera os dois dígitos da extrema direita. Para análise, isso será analisado usando o valor base de 2000, resultando em um ano dentro do intervalo de 2000 a 2099, inclusive. Se a contagem de letras for menor que quatro (mas não duas), o sinal será apenas de saída por anos negativos. Caso contrário, o sinal será apresentado se a largura do preenchimento for excedida quando "G" não estiver presente. 7 ou mais letras falharão.

• Mês: segue a regra de Número/Texto. O formulário de texto depende de letras – 'M' denota o formulário "padrão" e 'L' é para o formulário "autônomo". Essas duas formas são diferentes somente em alguns idiomas específicos. Por exemplo, em russo, "Июль" é a forma autônoma de julho e "Июля" é o formulário padrão. Aqui estão exemplos de todas as letras padrão com suporte:

  • 'M' ou 'L' : o número do mês em um ano começando em 1. Não há nenhuma diferença entre 'M' e 'L'. O mês de 1 a 9 é mostrado sem preenchimento.

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

  • 'MM' ou 'LL' : o número do mês em um ano começando em 1. O preenchimento zero é adicionado para os meses de 1 a 9.

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

  • 'MMM': representação textual curta no formulário padrão. O padrão de mês deve ser parte de um padrão de data não apenas um mês autônomo, exceto localidades em que não há nenhuma diferença entre formatos autônomos, como em 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 curta no formulário padrão. Ele é 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 am-pm-of-day. A contagem de letras do padrão deve ser 1.

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

• Nomes de zona(z): isso gera o nome textual de exibição da ID de fuso horário. Se a contagem de letras for uma, duas ou três, o nome curto será a saída. Se a contagem de letras for quatro, o nome completo será a saída. Haverá falha em cinco ou mais letras.

• Offset-X e x: formata a diferença com base no número de letras do padrão. Uma letra gera apenas a hora, como "+01", a menos que o minuto seja diferente de zero, caso o minuto também seja resultado, como "+0130". Duas letras geram a hora e o minuto, sem dois-pontos, como "+0130". Duas letras geram a hora e o minuto, com dois-pontos, como "+01:30". Quatro letras geram a hora e o minuto, além do segundo opcional, sem dois-pontos, como "+013015". Cinco letras geram a hora e o minuto, além do segundo opcional, com dois-pontos, como "+01:30:15". Seis ou mais letras falharão. A letra do padrão "X" (maiúscula) produzirá "Z" quando a diferença de saída for zero, enquanto a letra de padrão "x" (minúsculo) produzirá "+00", "+0000" ou "+00:00".

• Offset-O: formata a diferença localizada com base no número de letras do padrão. Uma letra gera a forma abreviada da diferença localizada, que é texto de diferença localizada, como "GMT", com hora sem zero à esquerda, minuto de 2 dígitos opcional e segundo, se não for zero, e dois-pontos, por exemplo, "GMT+8". As quatro letras geram a forma completa, que é o texto de diferença localizado, como "GMT", com o campo de hora e minuto de 2 dígitos, o segundo campo opcional se for diferente de zero e dois-pontos, por exemplo, "GMT+08:00". Qualquer outra contagem de letras falhará.

• Offset-Z: formata a diferença com base no número de letras do padrão. Duas letras geram a hora e o minuto, sem dois-pontos, como "+0130". A saída será "+0000" quando a diferença for zero. Quatro letras geram a forma completa de diferença localizado, equivalente a quatro letras de Offset-O. A saída será o texto de diferença localizada correspondente se a diferença for zero. As cinco letras geram a hora, minuto, com o segundo opcional, se for diferente de zero, com dois-pontos. Isso gerará "Z" se a diferença for zero. Seis ou mais letras falharão.

• Início e término 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 gerados mesmo que estejam na seção opcional. Durante a análise, a seção inteira pode estar ausente da cadeia de caracteres analisada. Uma seção opcional é iniciada pelo [ e terminada usando ] (ou no final do padrão).

• Os símbolos "E", "F", "q" e "Q" só podem ser usados para formatação de datetime, por exemplo, date_format. Eles não têm permissão para usar a análise de datetime, por exemplo, to_timestamp.

Artigos relacionados

• Função 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