Função CDOW( )

Retorna o nome do dia da semana para uma data ou datahora especificada. Abreviação de "Caractere Dia da Semana".

Sintaxe

CDOW(data/datahora; comprimento)

Parâmetros

Nome Tipo Descrição
data/datahora

datahora

O campo, expressão ou valor literal do qual será obtido o nome do dia da semana.
comprimento

numérico

Um valor entre 1 e 9 que especifica o comprimento da cadeia de saída. Para exibir nomes de dia abreviados, especifique um valor menor.

Saída

Caractere.

Exemplos

Exemplos básicos

Retorna "Quarta-feira" porque 31 de dezembro de 2014 é uma quarta-feira e o comprimento é 9:

CDOW(`20141231`; 12)

Retorna "Qua" porque 31 de dezembro de 2014 é uma quarta-feira e o comprimento é 3:

CDOW(`20141231 235959`; 3)

Retorna o nome completo do dia para cada valor no campo Data_fatura:

CDOW(Data_fatura; 9)

Retorna o nome abreviado do dia para cada valor do campo Carimbo_de_data_e_hora_do_recebimento:

CDOW(Carimbo_de_data_e_hora_do_recebimento; 3)

Exemplos avançados

Adição de um campo que identifica os dias da semana para datas

Use a função CDOW( ) para criar um campo calculado que identifica os dias da semana para todas as datas em um campo de data. Depois de criar o campo calculado, é possível adicioná-lo à exibição ao lado da coluna data:

DEFINE FIELD Nome_do_Dia COMPUTED CDOW(Data_de_trans; 3)

Criação de um filtro para testar as transações ocorridas em um fim de semana

Use a função CDOW( ) para criar um filtro que isola as transações ocorridas em um fim de semana:

SET FILTER TO CDOW(Data_de_trans, 3) = "Sat" OR CDOW(Data_de_trans, 3) = "Sun"

Observações

Detalhes do parâmetro

Um campo especificado para data/datahora pode usar qualquer formato de data ou datahora, desde que a definição do campo defina corretamente o formato.

Se o parâmetro comprimento for mais curto que o nome do dia, o nome do dia será truncado no comprimento especificado. Se o parâmetro comprimento for maior do que o nome do dia, o nome do dia será preenchido com espaços em branco.

Especificação de literal de data ou de um valor datahora

Ao especificar um valor literal de data ou datahora para data/datahora, você fica restrito aos formatos na tabela abaixo e o valor deve estar entre apóstrofos invertidos – por exemplo, `20141231`.

Não use separadores como barras (/) ou dois pontos (:) entre os componentes individuais de datas ou horas.

  • Valores de datahora – você pode usar qualquer combinação de formatos de data, separador e hora listados na tabela abaixo. A data deve preceder a hora e um separador deve ser usado entre os dois. Os separadores válidos são um único espaço em branco ou as letras 't' ou 'T'.

  • Valores de tempo – as horas devem ser especificadas usando o relógio de 24 horas. Os ajustes do Tempo Universal Coordenado (UTC) devem ser precedidos por um sinal de mais (+) ou de menos (-).

    Exemplos de formato

    Exemplos de valores literais

    AAAAMMDD

    `20141231`

    AAMMDD

    `141231`

    AAAAMMDD hhmmss

    `20141231 235959`

    AAMMDDthhmm

    `141231t2359`

    AAAAMMDDThh

    `20141231T23`

    AAAAMMDD hhmmss+/-hhmm

    (ajuste UTC)

    `20141231 235959-0500`

    AAMMDD hhmm+/-hh

    (ajuste UTC)

    `141231 2359+01`

    Nota

    Não use somente hh no formato de hora principal com dados que têm um ajuste UTC. Por exemplo, evite: hh+hhmm. Os resultados podem ser não confiáveis.

     

Funções relacionadas

Se precisar retornar o dia da semana como um número (1 a 7), use DOW( ) em vez de CDOW( ).

Guia de scripting do ACL 14.1