@nepali-utils/core

1
2
3
4
import { bsToAd } from "@nepali-utils/core"
 
const date = bsToAd({ year: 2081, month: 5, day: 15 })
// → Date (JavaScript Date object)

1
2
3
4
import { adToBs } from "@nepali-utils/core"
 
const bsDate = adToBs(new Date())
// → { year: 2081, month: 5, day: 15 }

1
2
3
4
import { getTodayBs } from "@nepali-utils/core"
 
const today = getTodayBs()
// → { year: 2081, month: 5, day: 15 }

1
2
3
4
import { getBsDayOfWeek } from "@nepali-utils/core"
 
const dayOfWeek = getBsDayOfWeek({ year: 2081, month: 5, day: 15 })
// → 0 (Sunday) through 6 (Saturday)

1
2
3
4
5
6
7
8
9
10
11
12
13
import { formatBsDate } from "@nepali-utils/core"
 
formatBsDate(date, "en", { pattern: "YYYY MMMM DD" })
// → "2081 Bhadra 15"
 
formatBsDate(date, "ne", { pattern: "YYYY MMMM DD" })
// → "२०८१ भदौ १५"
 
formatBsDate(date, "en", { pattern: "YYYY-MM-DD" })
// → "2081-05-15"
 
formatBsDate(date, "en", { pattern: "MMMM DD, YYYY" })
// → "Bhadra 15, 2081"

1
2
3
4
5
6
import { toNepaliNumber, parseNepaliNumber } from "@nepali-utils/core"
 
toNepaliNumber(2081)     // → "२०८१"
toNepaliNumber(12345)    // → "१२३४५"
 
parseNepaliNumber("२०८१") // → 2081

1
2
3
4
5
6
7
import { getPrevMonth, getNextMonth, MONTHS } from "@nepali-utils/core"
 
getPrevMonth(2081, 5)  // → { year: 2081, month: 4 }
getNextMonth(2081, 5)  // → { year: 2081, month: 6 }
 
MONTHS.en  // → ["Baisakh", "Jestha", "Ashad", ...]
MONTHS.ne  // → ["बैशाख", "जेष्ठ", "असार", ...]

1
2
3
4
5
import { generateCalendarGrid, type CalendarDay } from "@nepali-utils/core"
 
const grid: CalendarDay[] = generateCalendarGrid(2081, 5)
// Returns an array of CalendarDay objects with day, month, year,
// isCurrentMonth, isToday, dayOfWeek, and date properties.

1
2
3
4
5
6
7
8
9
10
import { getDaysInBsMonth, getDaysInBsYear, isValidBsYear, getBsYearRange, validateBsDate } from "@nepali-utils/core"
 
getDaysInBsMonth(2081, 5)  // → number of days in Bhadra 2081 (e.g. 32)
getDaysInBsYear(2081)      // → total days in BS year 2081 (e.g. 365)
isValidBsYear(2081)        // → true
getBsYearRange()           // → { min: 2000, max: 2100 }
 
// Validate a BS date — throws if invalid
validateBsDate(2081, 5, 15) // → undefined (valid)
validateBsDate(2081, 13, 1) // → throws "Invalid BS month: 13"

1
2
3
4
5
6
7
8
9
import { provinces, getProvinceById, getProvinceByNameEn } from "@nepali-utils/core"
 
provinces  // → ProvinceInfo[] (all 7 provinces)
 
getProvinceById("1a2d297a-b4d4-4062-9801-62813c324753")
// → { id: "...", name: "कोशी प्रदेश", nameEn: "Koshi Province" }
 
getProvinceByNameEn("Bagmati Province")
// → { id: "...", name: "बागमती प्रदेश", nameEn: "Bagmati Province" }

1
2
3
4
5
6
7
8
9
import { districts, getDistrictById, getDistrictsByProvince } from "@nepali-utils/core"
 
districts  // → DistrictInfo[] (all 77 districts)
 
getDistrictById("6accfa6f-c4ab-4b95-b0bf-aaf740375f62")
// → { id: "...", provinceId: "...", name: "ताप्लेजुङ", nameEn: "Taplejung", ... }
 
getDistrictsByProvince("1a2d297a-b4d4-4062-9801-62813c324753")
// → DistrictInfo[] (districts in Koshi province)

1
2
3
4
5
6
7
8
9
10
import { municipalities, getMunicipalityById, getMunicipalitiesByDistrict } from "@nepali-utils/core"
 
getMunicipalityById(1)
// → { id: 1, districtId: 1, nameEn: "...", nameNe: "...", type: "...", ... }
 
getMunicipalitiesByDistrict(1)
// → MunicipalityInfo[]
 
getMunicipalitiesByProvince(1)
// → MunicipalityInfo[] (all municipalities in Koshi)

1
2
3
4
5
6
7
8
9
10
import { wards, getWardsByMunicipality, getWardsByDistrict, getWardsByProvince } from "@nepali-utils/core"
 
getWardsByMunicipality(1)
// → WardInfo[]
 
getWardsByDistrict(1)
// → WardInfo[]
 
getWardsByProvince(1)
// → WardInfo[]

1
2
3
4
5
6
7
8
9
10
11
import { isValidNepaliMobile, getPhoneType, formatNepaliPhone } from "@nepali-utils/core"
 
isValidNepaliMobile("9841234567") // → true
isValidNepaliMobile("12345")     // → false
 
getPhoneType("9841234567") // → "NTC" (Nepal Telecom)
getPhoneType("9861234567") // → "NTC"
getPhoneType("9851234567") // → "Ncell"
 
formatNepaliPhone("9841234567")
// → "984-1234567"

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
import { formatNepaliCurrency } from "@nepali-utils/core"
 
// Default — Nepali numerals with रु symbol
formatNepaliCurrency(12345.67)
// → "रु १२,३४५.६७"
 
// English output
formatNepaliCurrency(12345.67, { lang: "en" })
// → "Rs. 12,345.67"
 
// Hide symbol
formatNepaliCurrency(1000, { symbol: false })
// → "१,०००.००"
 
// Whole number only (no decimals)
formatNepaliCurrency(1000, { decimal: false })
// → "रु १,०००"
 
// Negative amounts
formatNepaliCurrency(-500)
// → "रु -५००.००"

1
2
3
4
5
6
7
8
9
10
import { toNepaliWords } from "@nepali-utils/core"
 
toNepaliWords(0)         // → "शून्य"
toNepaliWords(5)         // → "पाँच"
toNepaliWords(100)       // → "एक सय"
toNepaliWords(1000)      // → "एक हजार"
toNepaliWords(12345)     // → "बाह्र हजार तीन सय पैंतालीस"
toNepaliWords(100000)    // → "एक लाख"
toNepaliWords(10000000)  // → "एक करोड"
toNepaliWords(-50)       // → "ऋण पचास"

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
import { MONTHS } from "@nepali-utils/core"
 
MONTHS
// → [
//   { value: 1,  nameEn: "Baisakh", nameNe: "बैशाख" },
//   { value: 2,  nameEn: "Jestha",  nameNe: "जेष्ठ" },
//   { value: 3,  nameEn: "Ashadh",  nameNe: "आषाढ" },
//   { value: 4,  nameEn: "Shrawan", nameNe: "श्रावण" },
//   { value: 5,  nameEn: "Bhadra",  nameNe: "भाद्र" },
//   { value: 6,  nameEn: "Ashwin",  nameNe: "आश्विन" },
//   { value: 7,  nameEn: "Kartik",  nameNe: "कार्तिक" },
//   { value: 8,  nameEn: "Mangsir", nameNe: "मंसिर" },
//   { value: 9,  nameEn: "Poush",   nameNe: "पौष" },
//   { value: 10, nameEn: "Magh",    nameNe: "माघ" },
//   { value: 11, nameEn: "Falgun",  nameNe: "फाल्गुन" },
//   { value: 12, nameEn: "Chaitra", nameNe: "चैत्र" },
// ]

1
2
3
4
5
6
7
import { WEEKDAYS } from "@nepali-utils/core"
 
WEEKDAYS[0]
// → { value: 0, shortEn: "Sun", shortNe: "आइत", longEn: "Sunday", longNe: "आइतबार" }
 
WEEKDAYS[6]
// → { value: 6, shortEn: "Sat", shortNe: "शनि", longEn: "Saturday", longNe: "शनिबार" }