Date
Gerenciamento de calendário e datas
operações como adição e subtração de dias, meses e anos, garantindo o tratamento preciso de várias complexidades relacionadas a datas, como anos bissextos e cálculos de final de mês
Importação
_ <- fat.extra.Date
biblioteca time, biblioteca math, tipo Error, tipo Text, tipo List, tipo Number, tipo Duration são automaticamente importados com esta importação
Tipo Date
Date oferece uma solução abrangente para o gerenciamento de datas, incluindo anos bissextos e horário do dia.
Propriedades
year: Número - Ano da datamonth: Número - Mês da dataday: Número - Dia da datatms: Milissegundos - Horário do dia em milissegundos
valor padrão aponta para: 1 de janeiro de 1970
Membros do protótipo
| Nome | Assinatura | Breve descrição |
|---|---|---|
| fromEpoch | (ems: Epoch): Date | Cria uma instância a partir de um epoch |
| isLeapYear | (year: Número): Boolean | Determina se um ano é bissexto |
| normalizeMonth | (month: Número): Número | Normaliza o número do mês |
| daysInMonth | (year: Número, month: Número): Número | Retorna o número de dias no mês de um ano |
| isValid | (year, month, day, tms): Boolean | Valida os componentes da data |
| truncate | <> Date | Trunca o horário do dia |
| toEpoch | <> Epoch | Converte a instância para tempo em epoch |
| toText | <> Text | Converte a instância para formato texto |
| addYears | (yearsToAdd: Número): Date | Adiciona anos à data |
| addMonths | (monthsToAdd: Número): Date | Adiciona meses à data |
| addWeeks | (weeksToAdd: Número): Date | Adiciona semanas à data |
| addDays | (daysToAdd: Número): Date | Adiciona dias à data |
| some | <> Option | Envolve o valor em Option |
Exemplos de uso
_ <- fat.extra.Date
# Criar uma instância de Data
myDate = Date(2023, 1, 1)
# Adicionar um ano à data
newDate = myDate.addYears(1)
# Adicionar duas semanas à uma data
datePlusTwoWeeks = myDate.addWeeks(2)
# Criar uma Data a partir de um tempo em epoch (em milissegundos)
# o resultado é influenciado pelo fuso horário atual, veja: time.setZone
epochTime = 1672531200000
dateFromEpoch = Date.fromEpoch(Epoch(epochTime))
# Converter uma data para tempo em epoch
epochFromDate = myDate.toEpoch