sghimire / nepali-date-library

1.0.1 2026-08-10 10:40 UTC

Requires

• php: >=7.1

Requires (Dev)

• phpunit/phpunit: ^7.5 || ^8.5 || ^9.6 || ^10.5 || ^11.5

MIT

• Sandip Ghimire

• php
• nepali
• date-converter
• nepal
• nepali-date
• nepali-calendar
• nepali-date-converter
• bikram-sambat
• date-conversion
• bs-to-ad
• ad-to-bs
• nepali-date-library
• bikram-sambat-date
• bs-date
• ad-bs

Published on Packagist.org on 2026-08-11 03:05 UTC

README

A modern, zero-dependency PHP library and Nepali Date Converter for working with Nepali (Bikram Sambat / BS) dates between 1976/01/01 and 2100/12/30 BS.

📖 Full Documentation & Live Tools

All guides, complete API references, Devanagari format tokens, fiscal year helpers, and interactive playground are hosted on our official documentation portal:

👉 https://nepali-pkg.date/docs/php
🔄 Try the Live Date Converter

📦 Installation

composer require sghimire/nepali-date-library

🚀 Quick Example

use NepaliDateLibrary\NepaliDate;

$today = new NepaliDate();
echo $today->format("YYYY-MM-DD"); // "2081-07-01"

Note: For complete API methods, standalone conversion (ADtoBS / BStoAD), date arithmetic, and fiscal year calculations, visit https://nepali-pkg.date/docs/php.

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide or visit our Online Contribution Guide.

📄 License

MIT © Sandip Ghimire
Made with ❤️ by Sandip Ghimire.