Skip to main content
Acessar Studio

DateTime

O módulo DateTime é responsável por realizar ações de manipulação de datas. Seus métodos podem ser acessados conforme o exemplo abaixo:

const date = await DateTime.addDate["v1_0_0"]({
  unit: 'd',
})

Métodos​

addDate​

Método responsável por adicionar uma unidade de tempo a uma data.

const date = await DateTime.addDate["v1_0_0"]({
  unit: 'd',
})

Parâmetros obrigatórios​

  • unit: String - espera uma string com a unidade de tempo que será adicionada. Os valores possíveis são:
    • y: ano;
    • M: mês;
    • d: dia;
    • w: semana;
    • h: hora;
    • m: minuto;
    • s: segundo;
    • ms: milissegundo.

Parâmetros opcionais​

  • date: String - espera uma string com a data que será manipulada. Se não for informado, será utilizada a data atual.
  • configuration: Object - espera um objeto com as configurações da data. Essas configurações devem ser obtidas através do método configurations.
  • inputFormat: String - espera uma string com o formato da data que será manipulada. Se não for informado, será utilizado o formato padrão americano (YYYY-MM-DD).
  • outputFormat: String - espera uma string com o formato da data que será retornada. Se não for informado, será utilizado o formato padrão americano (YYYY-MM-DD).
  • outputLocale: String - espera uma string com o idioma da data que será retornada. Se não for informado, será utilizado o idioma padrão. Os idiomas disponíveis são: pt-br e en.
  • quantity: Number - espera um número com a quantidade de unidades de tempo que serão adicionadas. Se não for informado, será utilizado o valor 1.

Retorno​

A constante ou variável criada, como a date do exemplo mostrado anteriormente, receberá uma string com a nova data manipulada.

calculateDateDifference​

Método responsável por calcular a diferença entre duas datas.

const date = await DateTime.calculateDateDifference["v1_0_0"]({
  startDate: '2020-01-01',
  endDate: '2020-01-02',
  unit: 'd',
})

Parâmetros obrigatórios​

  • startDate: String - espera uma string com a data inicial.
  • endDate: String - espera uma string com a data final.
  • unit: String - espera uma string com a unidade de tempo que será retornada. Os valores possíveis são:
    • y: ano;
    • M: mês;
    • d: dia;
    • w: semana;
    • h: hora;
    • m: minuto;
    • s: segundo;
    • ms: milissegundo.

Parâmetros opcionais​

  • inputStartDateFormat: String - espera uma string com o formato da data inicial que será manipulada. Se não for informado, será utilizado o formato padrão americano (YYYY-MM-DD).
  • inputEndDateFormat: String - espera uma string com o formato da data final que será manipulada. Se não for informado, será utilizado o formato padrão americano (YYYY-MM-DD).

Retorno​

A constante ou variável criada, como a date do exemplo mostrado anteriormente, receberá um número representando a diferença calculada entre as duas datas na unidade especificada.

checkHoliday​

Método responsável por verificar se uma data é feriado.

const isHoliday = await DateTime.checkHoliday["v1_0_0"]({
  configurations: configurations,
})

Parâmetros obrigatórios​

  • configurations: Object - espera um objeto com as configurações de feriados. Essas configurações devem ser obtidas através do método configurations.

Parâmetros opcionais​

  • date: String - espera uma string com a data que será verificada. Se não for informado, será utilizada a data atual.
  • inputFormat: String - espera uma string com o formato da data que será manipulada. Se não for informado, será utilizado o formato padrão (DD/MM/YYYY).

Retorno​

A constante ou variável criada, como a date do exemplo mostrado anteriormente, receberá um valor booleano, que será true se a data for feriado ou false caso contrário.

configurations​

Método responsável por criar uma configuração de feriados para os dias do ano.

const configurations = await DateTime.configurations["v1_0_0"]({
    holidays: {
        holidayPathFile: 'C:/Users/Roberty/Desktop/feriados.csv',
        delimiter: ';',
        format: 'DD/MM/YYYY',
    },
    weekdayHolidays: ['SATURDAY', 'SUNDAY']
})

Parâmetros obrigatórios​

Este método não possui parâmetros obrigatórios.

Parâmetros opcionais​

  • holidays: Object - espera um objeto com as informações dos feriados. Pode ser fornecido de duas formas:
    • Por arquivo: { holidayPathFile: String, delimiter: String, format: String } — carrega os feriados de um arquivo CSV.
      • holidayPathFile: String - caminho do arquivo CSV com as datas dos feriados.
      • delimiter: String - delimitador das colunas do CSV. Valor padrão: ;.
      • format: String - formato das datas no arquivo. Valor padrão: DD/MM/YYYY.
    • Por lista: { holidayList: String[], delimiter: String, format: String } — informa os feriados diretamente como um array de strings.
      • holidayList: String[] - array com as datas dos feriados.
      • delimiter: String - delimitador. Valor padrão: ;.
      • format: String - formato das datas. Valor padrão: DD/MM/YYYY.
  • weekdayHolidays: Array - espera um array com os dias da semana que serão considerados feriados. Os valores possíveis são: SATURDAY, SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY.

Retorno​

A constante ou variável criada, como a configurations do exemplo mostrado anteriormente, receberá um objeto com as configurações criadas. Esse objeto dará acesso as seguintes propriedades:

  • configurations.holidays: Object - retorna um objeto com as seguintes propriedades:
    • days: Object - retorna um objeto com as seguintes propriedades:
      • format: String - retorna uma string com o formato da data.
      • list: Array - retorna um array com os dias da semana que serão considerados feriados.
    • weekDays: Array - retorna um array com os dias da semana que serão considerados feriados.

formatDate​

Método responsável por formatar uma data.


const formattedDate = await DateTime.formatDate["v1_0_0"]({
  date: "2020-01-01",
  inputFormat: "yyyy-mm-dd",
  outputFormat: "yyyy-mm-dd"
})

Parâmetros obrigatórios​

Este método não possui parâmetros obrigatórios.

Parâmetros opcionais​

  • date: String - espera uma string com a data que será formatada. Se não for informado, será utilizada a data atual.
  • inputFormat: String - espera uma string com o formato da data que será manipulada. Se não for informado, será utilizado o formato padrão americano (YYYY-MM-DD).
  • outputFormat: String - espera uma string com o formato da data que será manipulada. Se não for informado, será utilizado o formato padrão americano (YYYY-MM-DD).
  • outputLocale: String - espera uma string com o idioma da data que será retornada. Se não for informado, será utilizado o idioma padrão. Os idiomas disponíveis são: pt-br e en.

Retorno​

A constante ou variável criada, como a formattedDate do exemplo mostrado anteriormente, receberá uma string com a data formatada.

getDateInformation​

Método responsável por obter informações de uma data.

const dateInformation = await DateTime.getDateInformation["v1_0_0"]({
  date: "2020-01-01",
  inputFormat: "yyyy-mm-dd",
})

Parâmetros obrigatórios​

Este método não possui parâmetros obrigatórios.

Parâmetros opcionais​

  • date: String - espera uma string com a data que será formatada. Se não for informado, será utilizada a data atual.
  • inputFormat: String - espera uma string com o formato da data que será manipulada. Se não for informado, será utilizado o formato padrão americano (YYYY-MM-DD).
  • locale: String - espera uma string com o idioma da data que será retornada. Se não for informado, será utilizado o idioma padrão. Os idiomas disponíveis são: pt-br e en.
  • configurations: Object - espera um objeto com as configurações da data. Essas configurações devem ser obtidas através do método configurations.

Retorno​

A constante ou variável criada, como a dateInformation do exemplo mostrado anteriormente, receberá um objeto com as informações da data. Esse objeto dará acesso as seguintes propriedades:

  • dateInformation.day: Number - retorna o número do dia da data.
  • dateInformation.dayName: String - retorna o nome do dia da semana da data.
  • dateInformation.firstDateOfTheMonth: String - retorna uma string com a data do primeiro dia do mês.
  • dateInformation.lastDateOfTheMonth: String - retorna uma string com a data do último dia do mês.
  • dateInformation.firstDateOfTheWeek: String - retorna uma string com a data do primeiro dia da semana.
  • dateInformation.lastDateOfTheWeek: String - retorna uma string com a data do último dia da semana.
  • dateInformation.firstWorkingDayOfTheMonth: Number - retorna o número do dia do primeiro dia útil do mês.
  • dateInformation.lastWorkingDayOfTheMonth: Number - retorna o número do dia do último dia útil do mês.
  • dateInformation.month: Number - retorna o número do mês da data.
  • dateInformation.monthName: String - retorna o nome do mês da data.
  • dateInformation.year: Number - retorna o número do ano da data.

removeDate​

Método responsável por remover uma unidade de tempo a uma data.

const date = await DateTime.removeDate["v1_0_0"]({
  date: "2020-01-01",
  inputFormat: "yyyy-mm-dd",
  unit: "day",
  value: 1
})

Parâmetros obrigatórios​

  • unit: String - espera uma string com a unidade de tempo que será removida. Os valores possíveis são:
    • y: ano;
    • M: mês;
    • d: dia;
    • w: semana;
    • h: hora;
    • m: minuto;
    • s: segundo;
    • ms: milissegundo.

Parâmetros opcionais​

  • date: String - espera uma string com a data que será formatada. Se não for informado, será utilizada a data atual.
  • inputFormat: String - espera uma string com o formato da data que será manipulada. Se não for informado, será utilizado o formato padrão americano (YYYY-MM-DD).
  • outputFormat: String - espera uma string com o formato da data que será manipulada. Se não for informado, será utilizado o formato padrão americano (YYYY-MM-DD).
  • outputLocale: String - espera uma string com o idioma da data que será retornada. Se não for informado, será utilizado o idioma padrão. Os idiomas disponíveis são: pt-br e en.
  • configurations: Object - espera um objeto com as configurações da data. Essas configurações devem ser obtidas através do método configurations.
  • quantity: Number - espera um número com a quantidade de unidades de tempo que será removida.

Retorno​

A constante ou variável criada, como a date do exemplo mostrado anteriormente, receberá uma string com a data subtraída.