Funções de Data e Hora¶

Introdução¶

Se você estiver usando essas funções em conjunto com o Now ou Now_ funções, esteja ciente de que o fuso horário retornado é aquele configurado na máquina que executa o agente. Todos os Agentes em Nuvem estão em UTC. Os Agentes Privados variam de acordo com a máquina específica em que cada agente está sendo executado. Se você estiver usando uma função de conversão, leve isso em consideração se o seu projeto for projetado para rodar tanto na nuvem quanto em um Agente Privado.

Códigos de Fuso Horário¶

Os parâmetros de fuso horário são um dos códigos de fuso horário padrão, seja um nome completo (código TZ), como "America/Los_Angeles", um deslocamento UTC como "UTC-8:00", ou uma abreviatura como "PST" (código de três letras). Os códigos de fuso horário diferenciam maiúsculas de minúsculas. Códigos TZ de nome completo são recomendados, se um fuso horário estiver sendo usado, pois "AST" pode se referir ao horário padrão "Atlântico" ou "Árabe".

• Os códigos TZ (uma lista não oficial) podem ser encontrados em https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.
• Os códigos de três letras estão listados em https://en.wikipedia.org/wiki/List_of_time_zone_abbreviations. Eles foram descontinuados pela IANA, embora sejam atualmente suportados.
• Informações adicionais podem ser encontradas em https://www.iana.org/time-zones.

Converter Horários UNIX em Datas¶

Se um horário UNIX for um número que inclui precisão de milissegundos, você poderá usar um código semelhante a este para converter um horário UNIX em uma data:

// If you have a UNIX timestamp with milliseconds such as
createdate = "1478119530707";
// You can convert it to a date by
// truncating the last three digits and using FormatDate:
date = double(Left(createdate, 10));
FormatDate(date, "yyyy-mm-dd");

ConvertTimeZone¶

Declaração¶

string ConvertTimeZone(date d, string fromTZ, string toTZ[, bool is_european_format, bool ignoreDST])

string ConvertTimeZone(string d, string fromTZ, string toTZ[, bool is_european_format, bool ignoreDST])

Sintaxe¶

ConvertTimeZone(<d>, <fromTZ>, <toTZ>[, <is_european_format>, <ignoreDST>])

Parâmetros Obrigatórios¶

• date: uma data, como objeto de data ou como string de data
• fromTZ: O fuso horário a ser convertido, expresso como um código de fuso horário
• toTZ: O fuso horário para o qual será convertido, expresso como código de fuso horário

Parâmetros Opcionais¶

• is_european_format: Este sinalizador opcional determina se o formato de data europeu deve ser usado. Quando true, o formato é dia e depois mês; quando false, o formato é mês e depois dia.

• ignoreDST: Por padrão, o horário de verão é contabilizado na conversão entre os quatro principais fusos horários dos EUA. Defina este sinalizador opcional como true para substituir esta ação.

Descrição¶

Pegue uma data e retorne-a convertida de um fuso horário para outro fuso horário.

Exemplos¶

ConvertTimeZone(Now(), "UTC", "America/Los_Angeles", false, false);
// If Now() returns "2017-03-10 18:34:37"
// returns "2017-03-10 10:34:37"

ConvertTimeZone("02/06/2017 5:25:00", "America/Los_Angeles", "America/New_York");
// Returns "2017-02-06 08:25:00" (shifts the time by 3 hours)

CVTDate¶

Declaração¶

string CVTDate(date d, string inputFormat, string outputFormat)

string CVTDate(string d, string inputFormat, string outputFormat)

Sintaxe¶

CVTDate(<d>, <inputFormat>, <outputFormat>)

Parâmetros Obrigatórios¶

• d: Um objeto de data ou string de data

• inputFormat: Uma string de formato, especificando o formato da data de entrada

• outputFormat: Uma string de formato, especificando o formato da data de saída

Descrição¶

Converte um objeto de data ou sequência de data no formato de entrada em uma sequência de data no formato de saída.

Exemplos¶

Nestes exemplos, presume-se que todos os agentes estão em execução na nuvem e os horários retornados seriam UTC. "myDate" é a data 19 de junho de 1994.

formato de Strings¶

O formato da sequência de data de entrada e da sequência de data de saída é especificado da mesma maneira usando caracteres para espaços reservados ou um dos quatro formatos de data predefinidos (GeneralDate, LongDate, MediumDate, ou ShortDate).

Para entradas, o ano, mês, dia, hora, minuto, segundo e AM/PM são lidos na sequência de data na posição onde y, m, d, H, M, S, SSS, e AP aparecem na string de formato de entrada.

Para saídas, a sequência de formato é copiada para a sequência de dados com o ano, mês, dia, hora, minuto e segundo substituindo os caracteres de y, m, d, H, M, S, SSS, e AP.

Alternativamente, as substituições usadas no método ANSI C strftime pode ser usado. Por exemplo, a cadeia "%Y-%m-%d" resultaria no formato de data ISO 8601 (yyyy-mm-dd). Consulte a documentação externa em strftime para uma descrição detalhada.

Esses códigos podem aparecer conforme necessário na string de formato para especificar como ler a entrada ou gravar a saída:

DateAdd¶

Declaração¶

string DateAdd(string datePart, int number, date d)

string DateAdd(string datePart, int number, string d)

Sintaxe¶

DateAdd(<datePart>, <number>, <d>)

Parâmetros Obrigatórios¶

• datePart: Um código de parte que descreve a parte da data à qual aplicar a adição
• number: Um número inteiro a ser adicionado à parte da data
• d: O objeto de data ou uma string de data a ser operada

Descrição¶

Retorna uma string de data após adicionar um número a uma parte especificada de um objeto de data.

Estes códigos são usados para descrever as partes da data:

Exemplos¶

DateAdd("yyyy", 1, Now());
// Adding one year to a date
// If Now() returns 2017-03-10 18:46:41
// returns "2018-03-10 18:46:41"

DateAdd("dd", 1, "2017-03-10");
// Adding one day to a date
// Returns "2017-03-11"

DayOfMonth¶

Declaração¶

int DayOfMonth(date d)

int DayOfMonth(string d)

Sintaxe¶

DayOfMonth(<d>)

Parâmetros Obrigatórios¶

• d: um objeto de data ou string de data

Descrição¶

Retorna o dia do mês (1-31) de um objeto de data ou sequência de data.

Exemplos¶

DayOfMonth(Now());
// Returns 25 if today is December 25

DayOfWeek¶

Declaração¶

int DayOfWeek(date d)

int DayOfWeek(string d)

Sintaxe¶

DayOfWeek(<d>)

Parâmetros Obrigatórios¶

• d: Um objeto de data ou string de data

Descrição¶

Retorna o dia da semana para um objeto de data ou sequência de data, com 0 para domingo, 1 para segunda-feira e 6 para sábado.

Esta definição é independente da localidade. Para saber o nome do dia da semana, ligue FormatDate em vez de.

Exemplos¶

DayOfWeek(Now());
// Returns 0, if today is Sunday

Now() + (6 - DayOfWeek(Now()))*24*60*60;
// Returns the date object of the last day of the current week,
// assuming Saturday (day 6) is the last day of the week

FormatDate¶

Declaração¶

string FormatDate(date d, string format)

string FormatDate(string d, string format)

Sintaxe¶

FormatDate(<d>, <format>)

Parâmetros Obrigatórios¶

• d: Um objeto de data ou string de data
• format: Uma string de formato, especificando o formato da data de saída

Descrição¶

Converte um objeto de data em uma string de acordo com um format string. Isto é semelhante ao CVTDate função e usa as mesmas strings de formato.

Exemplos¶

FormatDate(Now(),"%w");
// Similar to DayOfWeek(Now()), except the return value
// is a string value of today's weekday name, such as "Wed"

FormatDate("2017-12-07","%A");
// Returns the weekday name of the date string, such as "Thursday"

LPadChar(String(Long(FormatDate(d, "yyyy")) - 1900), "0", 3) + FormatDate(d, "ddd");
// Returns, for a date d, a string formatted as a JD Edwards Date ("CYYDDD")
// If d = "2000-12-31" (a leap year), returns "100366"
// See https://docs.oracle.com/cd/E26228_01/doc.93/e21961/julian_date_conv.htm#WEAWX259

GeneralDate¶

Declaração¶

string GeneralDate(date d)

string GeneralDate(string d)

Sintaxe¶

GeneralDate(<d>)

Parâmetros Obrigatórios¶

• d: Um objeto de data ou string de data

Descrição¶

Retorna uma string no formato geral de data para um objeto de data ou string de data.

Exemplos¶

GeneralDate(Now());
// If Now() is 11:59:23 am on September 16, 2000,
// returns "09/16/2000 11:59:23 AM"

GeneralDate("2017-12-07");
// Returns "12/07/2017 12:00:00 AM"

GetUTCFormattedDate¶

Declaração¶

string GetUTCFormattedDate(date d, string time_zone_id[, bool is_european_format])

string GetUTCFormattedDate(string d, string time_zone_id[, bool is_european_format])

Sintaxe¶

GetUTCFormattedDate(<d>, <time_zone_id>[, <is_european_format>])

Parâmetros Obrigatórios¶

• d: Um objeto de data ou string de data

• time_zone_id: O fuso horário a ser convertido, expresso como código de fuso horário

Parâmetros Opcionais¶

• is_european_format: Este sinalizador opcional determina se o formato de data europeu deve ser usado. Quando true, o formato é dia e depois mês; quando false, o formato é mês e depois dia.

Descrição¶

Retorna uma string de data sem informações de hora. Converte um objeto de data ou sequência de data em uma sequência de acordo com um código de fuso horário.

Exemplos¶

// If Now() is 2017-12-09 18:46:41, then:

GetUTCFormattedDate(Now(), "UTC", false);
// Returns "2017-12-09"

GetUTCFormattedDate(Now(), "America/Los_Angeles", false);
// Returns "2017-12-09"

GetUTCFormattedDateTime¶

Declaração¶

string GetUTCFormattedDateTime(date d, string time_zone_id[, bool is_european_format])

string GetUTCFormattedDateTime(string d, string time_zone_id[, bool is_european_format])

Sintaxe¶

GetUTCFormattedDateTime(<d>, <time_zone_id>[, <is_european_format>])

Parâmetros Obrigatórios¶

• d: Um objeto de data ou string de data

• time_zone_id: O fuso horário a ser convertido, expresso como código de fuso horário

Parâmetros Opcionais¶

• is_european_format: Este sinalizador opcional determina se o formato de data europeu deve ser usado. Quando true, o formato é dia e depois mês; quando false, o formato é mês e depois dia.

Descrição¶

Retorna uma string de data com informações de hora. Converte um objeto de data ou sequência de data em uma sequência de acordo com um código de fuso horário.

Exemplos¶

// If Now() is 2017-12-09 18:46:21, then:

GetUTCFormattedDateTime(Now(), "UTC", false);
// Returns "2017-12-09T18:46:21Z"

GetUTCFormattedDateTime(Now(), "America/Los_Angeles", false);
// Returns "2017-12-10T02:46:21Z"

LastDayOfMonth¶

Declaração¶

date LastDayOfMonth(date d)

date LastDayOfMonth(string d)

Sintaxe¶

LastDayOfMonth(<d>)

Parâmetros Obrigatórios¶

• d: Um objeto de data ou string de data

Descrição¶

Retorna um objeto de data que representa o último dia do mês para um objeto de data ou sequência de data.

Exemplos¶

LastDayOfMonth(Now());
// If today is in February of a leap year,
// returns the date object of February 29

LongDate¶

Declaração¶

string LongDate(date d)

string LongDate(string d)

Sintaxe¶

LongDate(<d>)

Parâmetros Obrigatórios¶

• d: Um objeto de data ou string de data

Descrição¶

Retorna uma string no formato de data longa para um objeto de data ou string de data.

Exemplos¶

LongDate(Now());
// If Now() is 11:59:23 am on September 16, 2000,
// returns "Saturday, September 16, 2000"

LongTime¶

Declaração¶

string LongTime(date d)

string LongTime(string d)

Sintaxe¶

LongTime(<d>)

Parâmetros Obrigatórios¶

• d: Um objeto de data ou string de data

Descrição¶

Retorna uma string no formato longo para um objeto de data ou string de data.

Exemplos¶

LongTime(Now());
// If Now() is 11:59:23 am on September 16, 2000
// returns "11:59:23 AM"

MediumDate¶

Declaração¶

string MediumDate(date d)

string MediumDate(string d)

Sintaxe¶

MediumDate(<d>)

Parâmetros Obrigatórios¶

• d: Um objeto de data ou string de data

Descrição¶

Retorna uma string no formato de data médio para um objeto de data ou string de data.

Exemplos¶

MediumDate(Now());
// If Now() is 11:59:23 am on September 16, 2000
// returns "16-Sep-00"

MediumTime¶

Declaração¶

string MediumTime(date d)

string MediumTime(string d)

Sintaxe¶

MediumTime(<d>)

Parâmetros Obrigatórios¶

• d: Um objeto de data ou string de data

Descrição¶

Retorna uma string no formato de hora média para um objeto de data ou string de data.

Exemplos¶

MediumTime(Now());
// If Now() is 11:59:23 am on September 16, 2000
// returns "11:59 AM"

MonthOfYear¶

Declaração¶

int MonthOfYear(date d)

int MonthOfYear(string d)

Sintaxe¶

MonthOfYear(<d>)

Parâmetros Obrigatórios¶

• d: Um objeto de data ou string de data

Descrição¶

Retorna o mês (1-12) para um objeto de data ou sequência de data.

Exemplos¶

MonthOfYear(Now());
// If Now() is 11:59:23 am on September 16, 2000
// returns "9"

Now¶

Declaração¶

date Now()

Sintaxe¶

Now()

Descrição¶

Retorna um objeto de data que representa os valores de data e hora no momento em que a função foi executada. A fração de segundo é truncada.

Exemplos¶

Now();
// If Now() is 11:59:23 am on September 16, 2000,
// returns a date object representing 09/16/2000 11:59:23 AM

Now\_¶

Declaração¶

date Now_()

Sintaxe¶

Now_()

Descrição¶

Retorna um objeto de data que representa os valores de data e hora no momento em que a função foi executada. O valor de tempo inclui a fração de segundo (milissegundos).

Exemplos¶

Now_();
// If Now_() is 11:59:23.123 am on September 16, 2000
// returns a date object representing 09/16/2000 11:59:23.123 AM

ShortDate¶

Declaração¶

string ShortDate(date d)

string ShortDate(string d)

Sintaxe¶

ShortDate(<d>)

Parâmetros Obrigatórios¶

• d: Um objeto de data ou string de data

Descrição¶

Retorna uma string no formato de data abreviada para um objeto de data ou string de data.

Exemplos¶

ShortDate(Now());
// If Now() is 11:59:23 am on September 16, 2017
// returns "9/16/17"

ShortTime¶

Declaração¶

string ShortTime(date d)

string ShortTime(string d)

Sintaxe¶

ShortTime(<d>)

Parâmetros Obrigatórios¶

• d: Um objeto de data ou string de data

Descrição¶

Retorna uma string no formato de hora abreviada para um objeto de data ou string de data.

Exemplos¶

ShortTime(Now());
// If Now() is 11:59:23 am on September 16, 2017
// returns "11:59"