date-string-ist Utility

Introduction

This JavaScript library is designed to simplify date-related operations, specifically tailored for the Indian financial system. The library is crafted to assist in various date manipulations crucial for financial calculations, ensuring that all time values are in Indian Standard Time (IST) and date formats follow the "YYYY-MM-DD" pattern.

Installation

``bash
npm i @zero65tech/date-string-ist
`

Functions

$3

This function takes a Date object or a timestamp and returns the date in the format "YYYY-MM-DD". It adjusts the input date by adding 5.5 hours to it.

Example:
`javascript
const formattedDate = from(new Date()); // Returns a string representing today's date
`


$3

Returns the date string for the next day in the format "YYYY-MM-DD".

Example:
`javascript
const nextDay = tomorrow(); // Returns a string representing tomorrow's date
`


$3

Returns the date string for the current day in the format "YYYY-MM-DD".

Example:
`javascript
const currentDate = today(); // Returns a string representing today's date
`

$3

Returns the date string for the previous day in the format "YYYY-MM-DD".

Example:
`javascript
const previousDay = yesterday(); // Returns a string representing yesterday's date
`

$3

Returns the date string for seven days ago in the format "YYYY-MM-DD".

Example:
`javascript
const lastWeekDate = lastWeek(); // Returns a string representing the date seven days ago
`

$3

Shifts a given date string by a specified number of days. If no days are provided, the original date string is returned.

Example:
`javascript
const shiftedDate = shift('2024-01-30', 2); // Shifts the date two days ahead
// Output - '2024-02-01'
`

$3

Calculates the duration in days between two dates. If no start date is provided, it defaults to the current date.

Example:
`javascript
const duration = getDuration('2024-01-30', '2024-02-01'); // Returns the duration between the two dates
// Output - 2
`

$3

Returns the date string for the start of the week (Monday) for a given date.

Example:
`javascript
const weekStartDate = getWeekStart('2023-01-06'); // Returns the date of the Monday of the week
// Output - '2024-01-01'
`

$3

Returns the date string for the end of the week (Sunday) for a given date.

Example:
`javascript
const weekEndDate = getWeekEnd('2023-01-06'); // Returns the date of the Sunday of the week
// Output - '2024-01-07'
`

$3

Returns the start date string of the fiscal year for a given date. If no date is provided, it defaults to the current date.

Example:
`javascript
const fyStartDate = getFyStart('2023-06-01'); // Returns the start date of the fiscal year
// Output - '2023-04-01'
`

$3

Returns the end date string of the fiscal year for a given date. If no date is provided, it defaults to the current date.

Example:
`javascript
const fyEndDate = getFyEnd('2023-06-01'); // Returns the end date of the fiscal year
// Output - '2024-03-31'
`

$3

Returns the fiscal quarter for a given date in the format "q1", "q2", "q3", or "q4".

Example:
`javascript
const quarter = getQtr('2023-06-01'); // Returns the fiscal quarter for the date
// Output - 'q1'
`

$3

Returns the tax quarter for a given date in the format "q1", "q2", "q3", "q4", or "q5".

Example:
`javascript
const taxQuarter = getTaxQtr('2023-06-01'); // Returns the tax quarter for the date
// Output - 'q1'
`

$3

Returns the fiscal year for a given date in the format "fyYYYY".

Example:
`javascript
const fiscalYear = getFy('2023-06-01'); // Returns the fiscal year for the date
// Output - 'fy23'
`

$3

Calculates the duration in days of the fiscal year for a given date. If no date is provided, it defaults to the current date.

Example:
`javascript
const fyDuration = getFyDuration('2023-06-01'); // Returns the duration of the fiscal year
// Output - 366
``