Nepali Date Utilities

By ashokbasnet

★ 4.7/5 (3 ratings)1,000+ active installationsVersion 1.1.0

Nepali Date Utilities converts English (AD) dates to Nepali (BS) for posts, comments, shortcodes, blocks, and a monthly post calendar.

Description

Nepali Date Utilities converts English (AD) dates to Nepali (BS) for posts, comments, shortcodes, blocks, and a monthly post calendar. It helps Nepali sites show Bikram Sambat dates consistently across WordPress.

Features

  • Convert post and modified dates to Nepali
  • Convert comment dates
  • Bilingual display (BS + AD)
  • Devanagari or Arabic numerals
  • Home / front page modes: default format, relative “time ago”, or hide
  • Shortcodes: [ndu_today_date], [ndu_date_ago], [ndu_convert], [ndu_post_calendar]
  • Classic “Today Date in Nepali” widget (optional format)
  • Gutenberg blocks: Nepali Today Date and Nepali Post Calendar
  • Monthly BS post calendar with navigation, dual dates, optional post links, and accent color
  • Admin converter: English ↔ Nepali
  • Live format preview and format presets in settings

Shortcodes

  • [ndu_today_date] — today’s date
  • [ndu_today_date format="y m d, l"] — custom format
  • [ndu_date_ago] — relative time for the current post
  • [ndu_convert date="2024-10-31" from="eng" format="y m d"] — AD → BS
  • [ndu_convert date="2081-07-15" from="nep"] — BS → AD
  • [ndu_post_calendar] — monthly BS calendar
  • [ndu_post_calendar year="2081" month="7" lang="english" show_post_links="1" accent="#c62828"] — calendar with options

Format tokens

  • y — year (e.g. २०८१)
  • m — month name (e.g. कार्तिक)
  • d — day number
  • l — weekday
  • H / h — hour (24h / 12h)
  • i — minute
  • s — second
  • a — period of day (बिहान / दिउँसो / साँझ / राति)

PHP helpers

ndu_today_date(), `ndu_get_date_ago()`, `ndu_format_nepali_date( $timestamp, $format )`

Supported conversion range: AD 1944–2033 / BS 2000–2099.

Installation

  1. Upload the plugin folder to /wp-content/plugins/nepali-date-utilities, or install via Plugins → Add New.
  2. Activate Nepali Date Utilities.
  3. Go to Settings → Nepali Date Utilities to configure display options, try the converter, or preview the post calendar.

FAQ

Does this replace English dates site-wide?

When “Convert dates to Nepali” is enabled, post, modified, and comment dates use your Nepali format. You can switch to bilingual mode to show both BS and AD.

Can I convert a specific date?

Yes. Use the Converter tab in settings, or the [ndu_convert] shortcode.

How do I show a Nepali post calendar?

Use [ndu_post_calendar], or insert the Nepali Post Calendar block. Configure year, month, language, post links, and accent color. Arrows navigate between BS months.

Is there a Gutenberg block?

Yes. Insert Nepali Today Date or Nepali Post Calendar and configure options in the block sidebar.

Screenshots

Changelog

1.1.0

  • Redesigned settings UI (Settings API) with Display, Converter, Post Calendar, and Help tabs
  • Live format preview and format presets
  • Shared date formatter; safer conversion (no fatal errors on out-of-range dates)
  • Unicode Devanagari numerals; optional Arabic numerals
  • Bilingual BS + AD display mode
  • Comment date conversion
  • Home and front page date behavior
  • Improved period-of-day labels (बिहान / दिउँसो / साँझ / राति)
  • Shortcodes: format attribute on today date, [ndu_date_ago], [ndu_convert], [ndu_post_calendar]
  • Gutenberg blocks: Nepali Today Date, Nepali Post Calendar
  • BS post calendar with month navigation, dual dates, post links, accent color
  • Widget format field
  • Requires PHP 7.4+; WordPress 5.0+

1.0.16

  • Maintenance release