date.startOfMonth()

The startOfMonth method returns a new NepaliDate instance positioned on day 1 of the active Bikram Sambat month with time set to midnight. It is commonly used for monthly calendar views, statements, and aggregation buckets.

ImportCopy Anchor Link

import { NepaliDate } from "nepali-date-library";

SignatureCopy Anchor Link

startOfMonth(): NepaliDate;

ParametersCopy Anchor Link

This method does not take any parameters.

Return ValueCopy Anchor Link

• Type: NepaliDate
• Returns a new NepaliDate set to day 1 of the current year and month. The original instance is not modified.

ExamplesCopy Anchor Link

Getting the First Day of the MonthCopy Anchor Link

import { NepaliDate } from "nepali-date-library";

// 2081 Baisakh 25
const date = new NepaliDate(2081, 0, 25);

const start = date.startOfMonth();
console.log(start.format("YYYY-MM-DD")); // "2081-01-01"
console.log(start.getDate()); // 1

Calendar Header ComputationCopy Anchor Link

import { NepaliDate } from "nepali-date-library";

const today = new NepaliDate();
const firstDay = today.startOfMonth();

// Find weekday that the month begins on
console.log(firstDay.getDay()); // 0 = Sunday, 1 = Monday, etc.

RelatedCopy Anchor Link

• date.endOfMonth(): Return the last day of the current month.
• date.startOfYear(): Return the first day of the current year.
• date.daysInMonth(): Return total days in the month.