Bloco de Função STR2DT
O bloco de função STR2DT converte uma data arbitrária especificada em formato de texto inglês para um novo formato de data.
Entrada IN
Na entrada, é passado uma data e hora no formato DT#.
Entrada STR
Define a string para calcular a data.
A entrada pode definir uma data anterior a 1970. Para isso, é necessário usar um formato como "12/25/0000", que corresponde ao primeiro Natal. O primeiro número 12 é o mês e o segundo 25 é o dia. O ano deve ser inserido com quatro dígitos, caso contrário, apenas o valor do ano 2000 será considerado.
Símbolos Utilizados
| Descrição | Formato |
|---|---|
| Nome do Dia | 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sun' | 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat' |
| Dias da Semana | 'weekday' | 'weekdays' |
| Número | [+-]?[0-9]+ |
| Ordinal | 'first' | 'second' | 'third' | 'fourth' | 'fifth' | 'sixth' | 'seventh' | 'eighth' | 'ninth' | 'tenth' | 'eleventh' | 'twelfth' | 'next' | 'last' | 'previous' | 'this' |
| Textos Relativos | 'next' | 'last' | 'previous' | 'this' |
| Espaços em Branco | [ \t]+ |
| Unidades | (( 'sec' | 'second' | 'min' | 'minute' | 'hour' | 'day' | 'fortnight' | 'forthnight' | 'month' | 'year') 's'?) | 'weeks' | daytext |
Notações Baseadas em Dias
| Formato | Descrição | Exemplos |
|---|---|---|
| 'yesterday' | Meia-noite de ontem. | "yesterday 14:00" |
| 'midnight' | A hora é definida para 00:00:00 | |
| 'today' | A hora é definida para 00:00:00 | |
| 'now' | É ignorado. | |
| 'noon' | A hora é definida para 12:00:00 | "yesterday noon" |
| 'tomorrow' | Meia-noite de amanhã. | |
| 'back of' hour | 15 minutos depois de uma hora específica. | "back of 7pm", "back of 15" |
| 'front of' hour | 15 minutos antes de uma hora específica. | "front of 5am", "front of 23" |
| 'first day of' | Define o dia para o primeiro dia do mês atual. Isso também funciona com um mês e ano especificados. | "first day of January 2008" |
| 'last day of' | Define o dia para o último dia do mês atual. Isso também funciona com um mês e ano especificados. | "last day of next month" |
| ordinal space dayname space 'of' | Calcula o xº dia da semana no mês. | "first sat of July 2008" |
| 'last' space dayname space 'of' | Calcula o último dia da semana no mês. | "last sat of July 2008" |
| number space? (unit | 'week') | Calcula um deslocamento relativo para a data atual. | "+5 weeks", "12 day", "-7 weekdays" |
| ordinal space unit | Calcula o tempo relativo à unidade especificada. | "fifth day", "second month" |
| 'ago' | Calcula um ponto no tempo retroativo. | "2 days ago", "8 days ago 14:00", "2 months 5 days ago", "2 months ago 5 days", "2 days ago" |
| dayname | Vai para o próximo dia da semana. | "Monday" |
| reltext space 'week' | Calcula o formato especial "weekday + last/this/next week". | "Monday next week" |
Saída DT
Retorna a data e hora calculadas no formato DT#.
Saída ERR
Em caso de erro, a saída é verdadeira.