@roit/roit-date v1.10.5

ROIT Date Format

Usage

> npm i @roit/roit-date

Manipulating the date

import { formatDate, retrieveDate, Timezone } from '@roit/roit-date'

const date1 = '12/01/2021'
const date2 = '12/01/2021 00:00'
const date3 = '2021/01/12'
const date4 = '2021-01-12: 00:00'
const date5 = '2021-01-12T03:00:00.000Z'

// Timezone by default is 'America/Sao_Paulo'
formatDate(date1, { timezone: Timezone.AMERICA_SAO_PAULO }) // 2021-01-12T03:00:00.000Z
formatDate(date2) // 2021-01-12T03:00:00.000Z
formatDate(date3) // 2021-01-12T03:00:00.000Z
formatDate(date4) // 2021-01-12T03:00:00.000Z
formatDate(date5) // 2021-01-12T03:00:00.000Z

// Timezone by default is 'America/Sao_Paulo'
retrieveDate(date1, { timezone: Timezone.AMERICA_SAO_PAULO }) // 2021-01-12T00:00:00.000Z
retrieveDate(date2) // 2021-01-12T00:00:00.000Z
retrieveDate(date3) // 2021-01-12T00:00:00.000Z
retrieveDate(date4) // 2021-01-12T00:00:00.000Z
retrieveDate(date5) // 2021-01-12T00:00:00.000Z

Showing the date

import { showDateToUser, formatCompetence, Timezone } from '@roit/roit-date'

const date1 = '2021-02-12T03:00:00.000Z'
const date2 = '2021-02-01T00:00:00.000Z'

// Timezone by default is 'America/Sao_Paulo'
showDateToUser(date, { timezone: Timezone.AMERICA_SAO_PAULO }) // 12/02/2021
showDateToUser(date1, { hours: true }) // 12/02/2021 03:00
showDateToUser(date2) // 31/01/2021    -> Based on the timezone it will convert back to UTC -3 which is Sao Paulo

// Timezone by default is 'America/Sao_Paulo'
formatCompetence(date, { timezone: Timezone.AMERICA_SAO_PAULO }) // 02/2021
formatCompetence(date1) // 02/2021
formatCompetence(date2) // 01/2021     -> Based on the timezone it will convert back to UTC -3 which is Sao Paulo

New Date

import { newDate } from '@roit/roit-date'

newDate() // if actual date in America/Sao_Paulo is 2021-05-31T22:06:00.786Z the output will be 2021-06-01T01:06:00.786Z

Diff of two dates

import { diffDays } from '@roit/roit-date'

diffDays('2021/01/12', '13/01/2021') // outputs 1

ValidateDateFormat

import { validateDateFormat } from '@roit/roit-date'

validateDateFormat('invalid-date') // false
validateDateFormat('12/12/2021') // true