DB2 for z/OS - Datetime constants - Constantes de data e hora


Volta a página anterior

Volta ao Menu Principal


Desenvolvido por DORNELLES, Carlos Alberto - Analista de Sistemas - Brasília DF. - cad_cobol@hotmail.com

DB2 for z/OS - Datetime constants - Constantes de data e hora

A datetime constant is a character string constant of a particular format.

Uma constante de data e hora é uma constante de cadeia de caracteres de um formato específico.

Character-string constants are described under Character string constants.

As constantes da sequência de caracteres são descritas em Constantes da sequência de caracteres.

For information about the valid string formats, see String representations of datetime values.

Para obter informações sobre os formatos de string válidos, consulte Representações de strings de valores de data e hora.

Typically, character-string constants are used to represent constant datetime values in assignments and comparisons.
However, the ANSI/ISO SQL standard form of a datetime constant can be used to specifically denote the constant as a datetime constant instead of a character-string constant.
The format for the ANSI/ISO SQL standard datetime constants are as follows:

Normalmente, constantes de sequência de caracteres são usadas para representar valores de data e hora constantes em atribuições e comparações.
No entanto, a forma padrão ANSI / ISO SQL de uma constante de data e hora pode ser usada para denotar especificamente a constante como uma constante de data e hora em vez de uma constante de cadeia de caracteres.
O formato das constantes de data e hora do padrão ANSI / ISO SQL são os seguintes:

DATE string-constant
string-constant must contain a value that conforms to one of the valid formats for string representations of dates, subject to the following rules:
  • leading blanks are not allowed.
  • leading zeros can be omitted from the month and day elements of the date.
    An implicit specification of 0 is assumed for any digit that is omitted.
  • leading zeros must be included for the year element of the date.
  • trailing blanks can be included.

The data type of the value is DATE.

DATE string-constant
string-constant deve conter um valor que esteja em conformidade com um dos formatos válidos para representações de string de datas, sujeito às seguintes regras:
  • espaços em branco não são permitidos.
  • zeros à esquerda podem ser omitidos dos elementos de mês e dia da data.
    Uma especificação implícita de 0 é assumida para qualquer dígito omitido.
  • zeros à esquerda devem ser incluídos para o elemento ano da data.
  • espaços em branco à direita podem ser incluídos.

O tipo de dados do valor é DATE.

TIME string-constant
string-constant must contain a value that conforms to one of the valid formats for string representations of times, subject to the following rules:
  • leading blanks are not allowed.
  • leading zeros can be omitted from the hour elements of the time.
  • the seconds element of the time can be omitted.
  • trailing blanks can be included.
  • if the USA format is not used and the minutes and seconds are all zeros, the hour can be 24.
  • If the format is USA, the following additional rules apply:
    • the minutes element of the time can be omitted.
      For example, 1 PM is equivalent to 1:00 PM.
    • the letters A, M, and P can be specified in lowercase.
    • a single blank must precede the AM or PM.
    • the hour must not be greater than 12 and cannot be 0 except when the time is specified as 00:00 AM.

An implicit specification of 0 is assumed for any digit that is omitted.

The correspondence between the USA format and the ISO format (24-hour clock) is as follows:

  • 12:01 AM through 12:59 AM correspond to 00.01.00 through 00.59.00
  • 01:00 AM through 11:59 AM correspond to 01.00.00 through 11.59.00
  • 12:00 PM (noon) through 11:59 PM correspond to 12.00.00 through 23.59.00
  • 12:00 AM (midnight) corresponds to 24.00.00
  • 00:00 AM (midnight) corresponds to 00.00.00

The data type of the value is TIME.

TIME string-constant
string-constant deve conter um valor que esteja em conformidade com um dos formatos válidos para representações de string de tempos, sujeito às seguintes regras:
  • espaços em branco não são permitidos.
  • zeros à esquerda podem ser omitidos dos elementos de hora da hora.
  • o elemento de segundos do tempo pode ser omitido.
  • espaços em branco à direita podem ser incluídos.
  • se o formato dos EUA não for usado e os minutos e segundos forem zeros, a hora pode ser 24.
  • Se o formato for EUA, as seguintes regras adicionais se aplicam:
    • o elemento minutos da hora pode ser omitido.
      Por exemplo, 13h é equivalente a 13h.
    • as letras A, M e P podem ser especificadas em minúsculas.
    • um único espaço em branco deve preceder AM ou PM.
    • a hora não deve ser maior que 12 e não pode ser 0, exceto quando a hora for especificada como 00:00 AM.

Uma especificação implícita de 0 é assumida para qualquer dígito omitido.

A correspondência entre o formato dos EUA e o formato ISO (relógio de 24 horas) é a seguinte:

  • 0h01 a 0h59 corresponde a 0h01 a 0h59
  • 01h00 a 11h59 corresponde a 01h00 a 11h59
  • Das 12h (meio-dia) às 23h59 correspondem às 12h00 às 23h59
  • 00h00 (meia-noite) corresponde a 24h00
  • 00:00 AM (meia-noite) corresponde a 00h00
  • O tipo de dados do valor é TIME.

    TIMESTAMP string-constant
    string-constant must contain a value that conforms to one of the formats listed in the following tables, subject to the following rules:
    • leading blanks are not allowed.
    • trailing blanks can be included.
    • leading zeros can be omitted from the month, day, hour, and time zone hour elements of the timestamp.
      An implicit specification of 0 is assumed for any digit that is omitted.
    • leading zeros must be included for the minute, second, and time zone minute elements of the timestamp
    • the hour can be 24 if the minutes, seconds, and any fractional seconds are all zeroes.
    • the separator character that follows the seconds element can be omitted if fractional seconds are not included.
    • the number of digits of fractional seconds can vary from 0 to 12.
      An implicit specification of 0 is assumed if fractional seconds are omitted.
      The number of digits of fractional seconds determines the precision of the timestamp value.
    • an optional single blank can be included between the time and the time zone elements.
    • an optional time zone can be included, in one of the following formats:
      • ±th:tm, with values ranging from -24:00 to +24:00. A value of -0:00 is treated the same as +0:00.
      • ±th, with values ranging from -24 to +24 (an implicit specification of 00 is assumed for the time zone minute element)
      • uppercase Z to specify UTC

    The data type of the value depends on the content of the string constant (where p is the number of digits of fractional seconds in the constant):

    • TIMESTAMP(p) WITHOUT TIME ZONE if the content of the string constant conforms to the rules in the Table 1 table.
    • TIMESTAMP(p) WITH TIME ZONE if the content of the string constant conforms to the rules in the Table 2 table.
    TIMESTAMP string-constant
    string-constant deve conter um valor que esteja em conformidade com um dos formatos listados nas tabelas a seguir, sujeito às seguintes regras:
    • espaços em branco não são permitidos.
    • espaços em branco à direita podem ser incluídos.
    • zeros à esquerda podem ser omitidos dos elementos de hora do mês, dia, hora e fuso horário do carimbo de data / hora.
      Uma especificação implícita de 0 é assumida para qualquer dígito omitido.
    • zeros à esquerda devem ser incluídos para os elementos minuto, segundo e minuto do fuso horário do carimbo de data / hora
    • a hora pode ser 24 se os minutos, segundos e quaisquer segundos fracionários forem todos zeros.
    • o caractere separador que segue o elemento de segundos pode ser omitido se os segundos fracionários não forem incluídos.
    • o número de dígitos de segundos fracionários pode variar de 0 a 12. Uma especificação implícita de 0 é assumida se os segundos fracionários forem omitidos. O número de dígitos de segundos fracionários determina a precisão do valor do carimbo de data / hora. um único espaço em branco opcional pode ser incluído entre o tempo e os elementos de fuso horário. um fuso horário opcional pode ser incluído em um dos seguintes formatos:
      • ± th: tm, com valores variando de -24: 00 a +24: 00. Um valor de -0: 00 é tratado da mesma forma que +0: 00.
      • ± th, com valores variando de -24 a +24 (uma especificação implícita de 00 é assumida para o elemento minuto de fuso horário)
      • Z maiúsculo para especificar UTC

    O tipo de dados do valor depende do conteúdo da constante da string (onde p é o número de dígitos de segundos fracionários na constante):

  • TIMESTAMP (p) SEM FUSO HORÁRIO se o conteúdo da constante string está em conformidade com as regras da Tabela 1.
  • TIMESTAMP (p) WITH TIME ZONE se o conteúdo da constante string está em conformidade com as regras da Tabela 2.
  • Table 1. Formats used to specify a value for a data type of TIMESTAMP WITHOUT TIME ZONE

    Tabela 1. Formatos usados para especificar um valor para um tipo de dados de TIMESTAMP WITHOUT TIME ZONE

    Description TIMESTAMP(0) WITHOUT TIME ZONE 1, 3 TIMESTAMP(p) WITHOUT TIME ZONE 2, 3
    Blank between date and time portions and colons in time portion.

    Espaço em branco entre as partes da data e hora e dois pontos na parte do tempo.
    • yyyy-mm-dd hh:mm:ss
    • yyyy-mm-dd hh:mm:ss.
    • yyyy-mm-dd
      hh:mm:ss.nnnnnnnnnnnn
    Blank between date and time portions and periods in time portion.

    Em branco entre as partes de data e hora e períodos na parte de tempo.
    • yyyy-mm-dd hh.mm.ss
    • yyyy-mm-dd hh.mm.ss.
    • yyyy-mm-dd
      hh.mm.ss.nnnnnnnnnnnn
    Minus sign between date and time portions and colons in time portion.

    Sinal de menos entre as porções de data e hora e dois-pontos na porção de tempo.
    • yyyy-mm-dd-hh:mm:ss
    • yyyy-mm-dd-hh:mm:ss.
    • yyyy-mm-dd-hh:mm:ss.nnnnnnnnnnnn
    Minus sign between date and time portions and periods in time portion.

    Sinal de menos entre as partes de data e hora e períodos na parte de tempo.
    • yyyy-mm-dd-hh.mm.ss
    • yyyy-mm-dd-hh.mm.ss.
    • yyyy-mm-dd-hh.mm.ss.nnnnnnnnnnnn
    Notes:
    1. No fractional seconds; shown with and without optional trailing period after seconds
    2. p is the number of digits of fractional seconds.
      nnnnnnnnnnnn can range 1 - 12 instances of n
    3. As an additional format, the character T can be substituted as the separator between the date and time portions of the value.
    1. Sem segundos fracionários; mostrado com e sem ponto final opcional após segundos
    2. p é o número de dígitos de segundos fracionários. nnnnnnnnnnnn pode variar de 1 a 12 instâncias de n
    3. Como formato adicional, o caractere T pode ser substituído como separador entre as partes de data e hora do valor.

    Table 2. Formats used to specify a value for a data type of TIMESTAMP WITH TIME ZONE

    Tabela 2. Formatos usados para especificar um valor para um tipo de dados de TIMESTAMP WITH TIME ZONE

    Description TIMESTAMP(0) WITH TIME ZONE1, 3 TIMESTAMP(p) WITH TIME ZONE 2, 3
    Blank between date and time portions and colons in time portion, no space between time and time zone.

    Em branco entre as partes da data e hora e dois-pontos na parte do tempo, sem espaço entre a hora e o fuso horário.
    • yyyy-mm-dd hh:mm:ss±th:tm
    • yyyy-mm-dd hh:mm:ss±th
    • yyyy-mm-dd hh:mm:ss.±th:tm
    • yyyy-mm-dd hh:mm:ss.±th
    • yyyy-mm-dd
      hh:mm:ss.nnnnnnnnnnnn
      ±th:tm
    • yyyy-mm-dd
      hh:mm:ss.nnnnnnnnnnnn
      ±th
    Minus sign between date and time portions and colons in time portion.

    Sinal de menos entre as porções de data e hora e dois-pontos na porção de tempo.
    • yyyy-mm-dd-hh:mm:ss±th:tm
    • yyyy-mm-dd-hh:mm:ss±th
    • yyyy-mm-dd-hh:mm:ss.±th:tm
    • yyyy-mm-dd-hh:mm:ss.±th
    • yyyy-mm-dd-
      hh:mm:ss.nnnnnnnnnnnn
      ±th:tm
    • yyyy-mm-dd-
      hh:mm:ss.nnnnnnnnnnnn
      ±th
    Minus sign between date and time portions and periods in time portion.

    Sinal de menos entre as partes de data e hora e períodos na parte de tempo.
    • yyyy-mm-dd-hh.mm.ss±th:tm
    • yyyy-mm-dd-hh.mm.ss±th
    • yyyy-mm-dd-hh.mm.ss.±th:tm
    • yyyy-mm-dd-hh.mm.ss.±th
    • yyyy-mm-dd-hh.mm.ss.nnnnnnnnnnnn
      ±th:tm
    • yyyy-mm-dd-hh.mm.ss.nnnnnnnnnnnn
      ±th
    Blank between date and time portions, colons in time portion, blank between fractional seconds and sign for time zone.

    Em branco entre as partes de data e hora, dois pontos na parte de tempo, em branco entre as frações de segundos e sinal de fuso horário.
    • yyyy-mm-dd hh:mm:ss ±th:tm
    • yyyy-mm-dd hh:mm:ss ±th
    • yyyy-mm-dd hh:mm:ss. ±th:tm
    • yyyy-mm-dd hh:mm:ss. ±th
    • yyyy-mm-dd
      hh:mm:ss.nnnnnnnnnnnn
      ±th:tm
    • yyyy-mm-dd
      hh:mm:ss.nnnnnnnnnnnn
      ±th
    Blank between date and time portions and periods in time portion.

    Em branco entre as partes de data e hora e períodos na parte de tempo.
    • yyyy-mm-dd hh.mm.ss±th:tm
    • yyyy-mm-dd hh.mm.ss±th
    • yyyy-mm-dd hh.mm.ss.±th:tm
    • yyyy-mm-dd hh.mm.ss.±th
    • yyyy-mm-dd
      hh.mm.ss.nnnnnnnnnnnn
      ±th:tm
    • yyyy-mm-dd
      hh.mm.ss.nnnnnnnnnnnn
      ±th
    Notes:
    1. No fractional seconds; shown with and without optional trailing period after seconds
    2. p is the number of digits of fractional seconds.
      nnnnnnnnnnnn can range 1 - 12 instances of n
    3. As an additional format, the character T can be substituted as the separator between the date and time portions of the value.
    1. Sem segundos fracionários; mostrado com e sem ponto final opcional após segundos
    2. p é o número de dígitos de segundos fracionários.
      nnnnnnnnnnnn pode variar de 1 a 12 instâncias de n
    3. Como formato adicional, o caractere T pode ser substituído como separador entre as partes de data e hora do valor.

    Parent topic: Constants


    © Copyright IBM Corp.