khmer_intl

Khmer (km) internationalization helpers for Dart and Flutter.

khmer_intl gives you Khmer-friendly formatting utilities for digits, numbers, currency, dates, relative time, plural selection, and Khmer lunar support via khmer_lunar_chhankitek: ^1.0.0.

Preview

Features

• Latin digit -> Khmer digit conversion (123 -> ១២៣)
• Khmer digit -> Latin digit conversion
• Number formatting and KHR currency formatting (៛)
• Compact number formatting (e.g. 1.3លាន)
• Compact currency formatting (e.g. ៛ 1.2M, ៛ ១.២លាន)
• Percent formatting
• Khmer date formatting with month/weekday names
• Buddhist Era year option (AD + 543)
• Date preset constructors (shortDate, mediumDate, fullDate, fullDateTime, dateTime, time)
• Khmer relative time (e.g. ២ ម៉ោងមុន)
• Simple plural helper
• Structured plural helper with templates (KhmerPlural.of)
• Chhankitek lunar integration via khmer_lunar_chhankitek
• Number-to-Khmer words conversion (1250 -> មួយពាន់ពីររយហាសិប)
• Extension methods for int, num, String, and DateTime

Installation

dependencies:
  khmer_intl: ^0.1.1

khmer_lunar_chhankitek is already integrated as a dependency of khmer_intl, so users can install only khmer_intl and use lunar APIs through KhmerChhankitek.

Then run:

dart pub get

or (Flutter):

flutter pub get

Quick Start

import 'package:khmer_intl/khmer_intl.dart';

Digits

toKhmerDigits('1234567890');
// ១២៣៤៥៦៧៨៩០

'123'.toKhmerDigits();
// ១២៣

'១២៣'.toLatinDigits();
// 123

Number and Currency

2500.toKhmerCurrency(useKhmerDigits: true);
// ៛២,៥០០

1250000.toKhmerCompact(useKhmerDigits: true);
// ១.៣លាន

0.275.toKhmerPercent(useKhmerDigits: true, fractionDigits: 1);
// ២៧.៥%

KhmerNumberFormat.compactCurrency().format(1200000);
// ៛ 1.2M

KhmerNumberFormat.compactCurrency(
  khmerStyle: true,
  useKhmerDigits: true,
).format(1200000);
// ៛ ១.២លាន

Date Formatting

final date = DateTime(2026, 4, 14);

KhmerDateFormat('EEE dd MMMM yyyy', buddhistEra: true, useKhmerDigits: true)
    .format(date);
// អង្គារ ១៤ ខែមេសា ២៥៦៩

KhmerDateFormat.fullDate(buddhistEra: true, useKhmerDigits: true).format(date);
KhmerDateFormat.fullDateTime(useKhmerDigits: true).format(DateTime.now());
KhmerDateFormat.dateTime(useKhmerDigits: true).format(DateTime.now());
KhmerDateFormat.time(useKhmerDigits: true).format(DateTime.now());

Khmer date (Chhankitek):

final date = DateTime(2026, 4, 16);
final khmerDate = KhmerChhankitek.formatKhmerGregorianDate(date);
final lunarDate = KhmerChhankitek.toKhmerLunarDate(date);

print(khmerDate); // ថ្ងៃទី១៦ ខែមេសា ឆ្នាំ២០២៦
print(lunarDate.toString());

Relative Time

final now = DateTime.now();
final past = now.subtract(const Duration(hours: 2));

past.toKhmerRelativeTime(reference: now, useKhmerDigits: true);
// ២ ម៉ោងមុន

KhmerRelativeTime.format(now, reference: now);
// ឥឡូវនេះ

KhmerRelativeTime.format(now.subtract(const Duration(days: 1)), reference: now);
// ម្សិលមិញ

KhmerRelativeTime.format(now.subtract(const Duration(days: 5)), reference: now);
// មុន 5 ថ្ងៃ

Plural Helper

khmerPlural(
  2,
  one: 'មានទំនិញ 1 មុខ',
  other: 'មានទំនិញ 2 មុខ',
);

KhmerPlural.of(
  count: 2,
  one: '{count} ឯកតា',
  other: '{count} ឯកតា',
);
// 2 ឯកតា

Number to Khmer Words

numberToKhmerWords(1250);
// មួយពាន់ពីររយហាសិប

1250.toKhmerWords();
// មួយពាន់ពីររយហាសិប

Chhankitek Lunar Date (Integrated)

final date = DateTime(2026, 4, 16);

final lunarDate = KhmerChhankitek.toKhmerLunarDate(date);
final lunarDay = KhmerChhankitek.day(date);
final monthDays = KhmerChhankitek.month(date.year, date.month);

print(lunarDate.toString());
print(KhmerChhankitek.formatKhmerGregorianDate(date));
print('Uposatha: ${lunarDay.isUposatha}');
print('Days this month: ${monthDays.length}');

final isSil = KhmerChhankitek.isSilDay(date);
final isKor = KhmerChhankitek.isKorDay(date);

print('ថ្ងៃសីល: $isSil');
print('ថ្ងៃកោរ: $isKor');
print(
  '${KhmerChhankitek.formatKhmerGregorianDate(date)} ជា'
  '${isSil ? 'ថ្ងៃសីល' : (isKor ? 'ថ្ងៃកោរ' : 'ថ្ងៃធម្មតា')}',
);

Demo output:

ថ្ងៃព្រហស្បតិ៍ ១៤រោច ខែចេត្រ ឆ្នាំមមីរ អដ្ឋស័ក ព.ស.២៥៦៩
ថ្ងៃទី១៦ ខែមេសា ឆ្នាំ២០២៦
Uposatha: false
Days this month: 30
ថ្ងៃសីល: true
ថ្ងៃកោរ: false
ថ្ងៃទី១៦ ខែមេសា ឆ្នាំ២០២៦ ជាថ្ងៃសីល

Full source example:

import 'package:khmer_intl/khmer_intl.dart';

void main() {
  // Part 1: Today
  final now = DateTime.now();
  final today = KhmerChhankitek.day(now);
  final todayMonthDays = KhmerChhankitek.month(
    today.date.year,
    today.date.month,
  );
  final todayKhmerDate = KhmerChhankitek.toKhmerLunarDate(now);

  print('=== Today ===');
  print(todayKhmerDate.toString());
  print(KhmerChhankitek.formatKhmerGregorianDate(now));
  print('Uposatha: ${today.isUposatha}');
  print('Days this month: ${todayMonthDays.length}');
  final todayIsSil = KhmerChhankitek.isSilDay(now);
  final todayIsKor = KhmerChhankitek.isKorDay(now);
  print('ថ្ងៃសីល: $todayIsSil');
  print('ថ្ងៃកោរ: $todayIsKor');
  print(
    '${KhmerChhankitek.formatKhmerGregorianDate(now)} ជា'
    '${todayIsSil ? 'ថ្ងៃសីល' : (todayIsKor ? 'ថ្ងៃកោរ' : 'ថ្ងៃធម្មតា')}',
  );

  // Part 2: Specific day
  final specificDate = DateTime(2026, 5, 31);
  final specificDay = KhmerChhankitek.day(specificDate);
  final specificMonthDays = KhmerChhankitek.month(
    specificDay.date.year,
    specificDay.date.month,
  );
  final specificKhmerDate = KhmerChhankitek.toKhmerLunarDate(specificDate);

  print('=== Specific Day (2026-05-31) ===');
  print(specificKhmerDate.toString());
  print(KhmerChhankitek.formatKhmerGregorianDate(specificDate));
  print('Uposatha: ${specificDay.isUposatha}');
  print('Days this month: ${specificMonthDays.length}');
  final specificIsSil = KhmerChhankitek.isSilDay(specificDate);
  final specificIsKor = KhmerChhankitek.isKorDay(specificDate);
  print('ថ្ងៃសីល: $specificIsSil');
  print('ថ្ងៃកោរ: $specificIsKor');
  print(
    '${KhmerChhankitek.formatKhmerGregorianDate(specificDate)} ជា'
    '${specificIsSil ? 'ថ្ងៃសីល' : (specificIsKor ? 'ថ្ងៃកោរ' : 'ថ្ងៃធម្មតា')}',
  );
}

Khmer New Year helper:

final ny = KhmerChhankitek.khmerNewYearByGregorianYear(2026);
print('hour: ${ny.timeOfNewYear.hour}');
print('minute: ${ny.timeOfNewYear.minute}');
print('dayLerngSak: ${ny.dayLerngSak}');

Demo output:

hour: 10
minute: 48
dayLerngSak: 3

Formatting helpers:

KhmerChhankitek.toKhmerDigits(123); // ១២៣
KhmerChhankitek.formatKhmerGregorianDate(date);
KhmerChhankitek.formatIsoDate(date); // 2026-04-16
KhmerChhankitek.formatIsoDateTime(date); // 2026-04-16 00:00:00

Lunar API Comparison

Use KhmerChhankitek when you need Khmer lunar engine features:

• Source: khmer_lunar_chhankitek integration
• Best for: day/month/year, isSilDay/isKorDay, Khmer New Year, Khmer date formatting helpers
• Range: 1900..2100 for day/year APIs
• Accuracy: engine-backed (recommended for production lunar calculations)

final date = DateTime(2026, 4, 16);
final day = KhmerChhankitek.day(date);
final isSil = KhmerChhankitek.isSilDay(date);
final ny = KhmerChhankitek.khmerNewYearByGregorianYear(2026);

Core APIs

Top-level functions

• toKhmerDigits(String input)
• toLatinDigits(String input)
• khmerPlural(num count, {required String one, required String other})

Formatters

• KhmerNumberFormat.decimal(...)
• KhmerNumberFormat.currencyKHR(...)
• KhmerNumberFormat.compact(...)
• KhmerNumberFormat.percent(...)
• KhmerCompactNumberFormat(...)
• KhmerPercentFormat(...)
• KhmerDateFormat(pattern, ...)
• KhmerDateFormat.shortDate(...)
• KhmerDateFormat.mediumDate(...)
• KhmerDateFormat.fullDate(...)
• KhmerDateFormat.fullDateTime(...)
• KhmerDateFormat.dateTime(...)
• KhmerDateFormat.time(...)
• KhmerRelativeTime.format(...)

Extensions

• int.toKhmerDigits()
• String.toKhmerDigits()
• String.toLatinDigits()
• num.toKhmerCurrency(...)
• num.toKhmerCompact(...)
• num.toKhmerPercent(...)
• DateTime.toKhmerDate(...)
• DateTime.toKhmerRelativeTime(...)
• DateTime.toKhmerChhankitekLunarDate()
• DateTime.toKhmerChhankitekLunarDay(...)
• DateTime.isKhmerChhankitekSilDay(...)
• DateTime.isKhmerChhankitekKorDay(...)
• DateTime.toKhmerChhankitekGregorianDate()
• DateTime.toKhmerChhankitekIsoDate()
• DateTime.toKhmerChhankitekIsoDateTime()

Flutter LocalizationsDelegate

A working Khmer LocalizationsDelegate example is included in:

• example/lib/khmer_localizations.dart
• example/lib/main.dart

localizationsDelegates: const [
  KhmerLocalizations.delegate,
]

Notes

• Chhankitek lunar support range is 1900..2100 for day/year APIs.
• Compact/percent styles are designed to be practical and lightweight.

Testing

dart test

License

MIT

Sponsor Me

If you find my projects helpful and want to support my work, you can sponsor me! 💖

GitHub Sponsors

Connect with Me

Make a Donation

---