# -*- coding: utf-8 -*-
"""
Thai date/time conversion and formatting
Note: Does not take into account the change of new year's day in Thailand
"""
# BE คือ พ.ศ.
# AD คือ ค.ศ.
# AH ปีฮิจเราะห์ศักราชเป็นปีพุทธศักราช จะต้องบวกด้วย 1122
# ไม่ได้รองรับปี พ.ศ. ก่อนการเปลี่ยนวันขึ้นปีใหม่ของประเทศไทย
import datetime
__all__ = [
"thai_abbr_months",
"thai_abbr_weekdays",
"thai_full_months",
"thai_full_weekdays",
"thai_strftime",
]
thai_abbr_weekdays = ["จ", "อ", "พ", "พฤ", "ศ", "ส", "อา"]
thai_full_weekdays = [
"วันจันทร์",
"วันอังคาร",
"วันพุธ",
"วันพฤหัสบดี",
"วันศุกร์",
"วันเสาร์",
"วันอาทิตย์",
]
thai_abbr_months = [
"ม.ค.",
"ก.พ.",
"มี.ค.",
"เม.ย.",
"พ.ค.",
"มิ.ย.",
"ก.ค.",
"ส.ค.",
"ก.ย.",
"ต.ค.",
"พ.ย.",
"ธ.ค.",
]
thai_full_months = [
"มกราคม",
"กุมภาพันธ์",
"มีนาคม",
"เมษายน",
"พฤษภาคม",
"มิถุนายน",
"กรกฎาคม",
"สิงหาคม",
"กันยายน",
"ตุลาคม",
"พฤศจิกายน",
"ธันวาคม",
]
_HA_DIGITS = "0123456789"
_TH_DIGITS = "๐๑๒๓๔๕๖๗๘๙"
_HA_TH_DIGITS = str.maketrans(_HA_DIGITS, _TH_DIGITS)
_NEED_L10N = "AaBbCcDFGgvXxYy+" # flags that need localization
_EXTENSIONS = "EO-_0#" # extension flags
_BE_AD_DIFFERENCE = 543
def _padding(n: int, length: int = 2, pad_char: str = "0") -> str:
str_ = str(n)
pad_len = length - len(str_)
if pad_len < 0:
pad_len = 0
return (pad_char * pad_len) + str_
def _thai_strftime(datetime: datetime.datetime, fmt_char: str) -> str:
"""
Conversion support for thai_strftime()
"""
str_ = ""
if fmt_char == "A":
# National representation of the full weekday name
str_ = thai_full_weekdays[datetime.weekday()]
elif fmt_char == "a":
# National representation of the abbreviated weekday
str_ = thai_abbr_weekdays[datetime.weekday()]
elif fmt_char == "B":
# National representation of the full month name
str_ = thai_full_months[datetime.month - 1]
elif fmt_char == "b":
# National representation of the abbreviated month name
str_ = thai_abbr_months[datetime.month - 1]
elif fmt_char == "C":
# Thai Buddhist century (AD+543)/100 + 1 as decimal number;
str_ = str(int((datetime.year + _BE_AD_DIFFERENCE) / 100) + 1)
elif fmt_char == "c":
# Locale’s appropriate date and time representation
# Wed 6 Oct 01:40:00 1976
# พ 6 ต.ค. 01:40:00 2519 <-- left-aligned weekday, right-aligned day
str_ = "{:<2} {:>2} {} {} {}".format(
thai_abbr_weekdays[datetime.weekday()],
datetime.day,
thai_abbr_months[datetime.month - 1],
datetime.strftime("%H:%M:%S"),
datetime.year + _BE_AD_DIFFERENCE,
)
elif fmt_char == "D":
# Equivalent to ``%m/%d/%y''
str_ = "{}/{}".format(
datetime.strftime("%m/%d"),
str(datetime.year + _BE_AD_DIFFERENCE)[-2:],
)
elif fmt_char == "F":
# Equivalent to ``%Y-%m-%d''
str_ = "{}-{}".format(
str(datetime.year + _BE_AD_DIFFERENCE), datetime.strftime("%m-%d")
)
elif fmt_char == "G":
# ISO 8601 year with century representing the year that contains the
# greater part of the ISO week (%V). Monday as the first day of the week.
str_ = str(int(datetime.strftime("%G")) + _BE_AD_DIFFERENCE)
elif fmt_char == "g":
# Same year as in ``%G'', but as a decimal number without century (00-99).
str_ = str(int(datetime.strftime("%G")) + _BE_AD_DIFFERENCE)[-2:]
elif fmt_char == "v":
# BSD extension, ' 6-Oct-1976'
str_ = "{:>2}-{}-{}".format(
datetime.day,
thai_abbr_months[datetime.month - 1],
datetime.year + _BE_AD_DIFFERENCE,
)
elif fmt_char == "X":
# Locale’s appropriate time representation.
str_ = datetime.strftime("%H:%M:%S")
elif fmt_char == "x":
# Locale’s appropriate date representation.
str_ = "{}/{}/{}".format(
_padding(datetime.day),
_padding(datetime.month),
datetime.year + _BE_AD_DIFFERENCE,
)
elif fmt_char == "Y":
# Year with century
str_ = str(datetime.year + _BE_AD_DIFFERENCE)
elif fmt_char == "y":
# Year without century
str_ = str(datetime.year + _BE_AD_DIFFERENCE)[2:4]
elif fmt_char == "+":
# National representation of the date and time
# (the format is similar to that produced by date(1))
# Wed 6 Oct 1976 01:40:00
str_ = "{:<2} {:>2} {} {} {}".format(
thai_abbr_weekdays[datetime.weekday()],
datetime.day,
thai_abbr_months[datetime.month - 1],
datetime.year + _BE_AD_DIFFERENCE,
datetime.strftime("%H:%M:%S"),
)
else:
# No known localization available, use Python's default
str_ = datetime.strftime(f"%{fmt_char}")
return str_
[docs]def thai_strftime(
datetime: datetime.datetime, fmt: str, thaidigit: bool = False
) -> str:
"""
This function convert :class:`datetime.datetime` into Thai date
and time format. The formatting directives are
similar to :func:`datatime.strrftime`.
This function uses Thai names and Thai Buddhist Era for these directives:
* **%a** - abbreviated weekday name
(i.e. "จ", "อ", "พ", "พฤ", "ศ", "ส", "อา")
* **%A** - full weekday name
(i.e. "วันจันทร์", "วันอังคาร", "วันเสาร์", "วันอาทิตย์")
* **%b** - abbreviated month name
(i.e. "ม.ค.","ก.พ.","มี.ค.","เม.ย.","พ.ค.","มิ.ย.", "ธ.ค.")
* **%B** - full month name
(i.e. "มกราคม", "กุมภาพันธ์", "พฤศจิกายน", "ธันวาคม",)
* **%y** - year without century (i.e. "56", "10")
* **%Y** - year with century (i.e. "2556", "2410")
* **%c** - date and time representation
(i.e. "พ 6 ต.ค. 01:40:00 2519")
* **%v** - short date representation
(i.e. " 6-ม.ค.-2562", "27-ก.พ.-2555")
Other directives will be passed to datetime.strftime()
:Note:
* The Thai Buddhist Era (BE) year is simply converted from AD
by adding 543. This is certainly not accurate for years
before 1941 AD, due to the change in Thai New Year's Day.
* This meant to be an interrim solution, since
Python standard's locale module (which relied on C's strftime())
does not support "th" or "th_TH" locale yet. If supported,
we can just locale.setlocale(locale.LC_TIME, "th_TH")
and then use native datetime.strftime().
We trying to make this platform-independent and support extentions
as many as possible, See these links for strftime() extensions
in POSIX, BSD, and GNU libc:
* Python
https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior
* C http://www.cplusplus.com/reference/ctime/strftime/
* GNU https://metacpan.org/pod/POSIX::strftime::GNU
* Linux https://linux.die.net/man/3/strftime
* OpenBSD https://man.openbsd.org/strftime.3
* FreeBSD https://www.unix.com/man-page/FreeBSD/3/strftime/
* macOS
https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man3/strftime.3.html
* PHP https://secure.php.net/manual/en/function.strftime.php
* JavaScript's implementation https://github.com/samsonjs/strftime
* strftime() quick reference http://www.strftime.net/
:param datetime.datetime datetime: an instantiatetd object of
:mod:`datetime.datetime`
:param str fmt: string containing date and time directives
:param bool thaidigit: If `thaidigit` is set to **False** (default),
number will be represented in Arabic digit.
If it is set to **True**, it will be represented
in Thai digit.
:return: Date and time text, with month in Thai name and year in
Thai Buddhist era. The year is simply converted from AD
by adding 543 (will not accurate for years before 1941 AD,
due to change in Thai New Year's Day).
:rtype: str
:Example:
::
import datetime
from pythainlp.util import thai_strftime
datetime_object = datetime.datetime(year=2019, month=6, day=10, \\
hour=15, minute=59, second=0, microsecond=0)
print(datetime_object)
# output: 2019-06-10 15:59:00
print(thai_strftime(datetime_object, "%A %d %B %Y "))
# output: วันจันทร์ 10 มิถุนายน 2562
print(thai_strftime(datetime_object, "%a %d %b %y "))
# output: จ 10 มิ.ย. 62
print(thai_strftime(datetime_object, "%D (%v)"))
# output: 06/10/62 (10-มิ.ย.-2562)
print(thai_strftime(datetime_object, "%D (%c)"))
# output: 06/10/62 (จ 10 มิ.ย. 15:59:00 2562)
"""
thaidate_parts = []
i = 0
fmt_len = len(fmt)
while i < fmt_len:
str_ = ""
if fmt[i] == "%":
j = i + 1
if j < fmt_len:
fmt_char = fmt[j]
if fmt_char in _NEED_L10N: # requires localization?
str_ = _thai_strftime(datetime, fmt_char)
elif fmt_char in _EXTENSIONS:
if fmt_char == "-":
# GNU libc extension, no padding
k = j + 1
if k < fmt_len:
fmt_char_nopad = fmt[k]
if (
fmt_char_nopad in _NEED_L10N
): # check if requires localization
str_ = _thai_strftime(datetime, fmt_char_nopad)
else:
# Windows may not support this
str_ = datetime.strftime(f"%-{fmt_char_nopad}")
i = i + 1 # consume char after "-"
else:
str_ = (
"-"
) # "-" at the end of string has no meaning
elif fmt_char == "_":
# GNU libc extension, explicitly specify space (" ") for padding
# Not implemented yet
pass
elif fmt_char == "0":
# GNU libc extension, explicitly specify zero ("0") for padding
# Not implemented yet
pass
elif fmt_char == "E":
# POSIX extension, uses the locale's alternative representation
# Not implemented yet
pass
elif fmt_char == "O":
# POSIX extension, uses the locale's alternative numeric symbols
# Not implemented yet
pass
elif fmt_char:
# the rest of directives, just pass to Python's standard strftime()
str_ = datetime.strftime(f"%{fmt_char}")
i = i + 1 # consume char after "%"
else:
str_ = "%"
else:
str_ = fmt[i]
thaidate_parts.append(str_)
i = i + 1
thaidate_text = "".join(thaidate_parts)
if thaidigit:
thaidate_text = thaidate_text.translate(_HA_TH_DIGITS)
return thaidate_text
[docs]def now_reign_year():
"""
This function return the reign year for the 10th King of Chakri dynasty.
:return: reign year of the 10th King of Chakri dynasty.
:rtype: int
:Example:
::
from pythainlp.util import now_reign_year
text = "เป็นปีที่ {reign_year} ในรัชกาลปัจจุบัน"\\
.format(reign_year=now_reign_year())
print(text)
# output: เป็นปีที่ 4 ในรัชการปัจจุบัน
"""
now_ = datetime.datetime.now()
return now_.year - 2015
[docs]def reign_year_to_ad(reign_year: int, reign: int) -> int:
"""
This function calculate the AD year according to the reign year for
the 7th to 10th King of Chakri dynasty, Thailand.
For instance, the AD year of the 4th reign year of the 10th King is 2019.
:param int reign_year: reign year of the King
:param int reign: the reign of the King (i.e. 7, 8, 9, and 10)
:return: the year in AD of the King given the reign and reign year.
:rtype: int
:Example:
::
from pythainlp.util import reign_year_to_ad
print("The 4th reign year of the King Rama X is in", \\
reign_year_to_ad(4, 10))
# output: The 4th reign year of the King Rama X is in 2019
print("The 1st reign year of the King Rama IX is in", \\
reign_year_to_ad(1, 9))
# output: The 4th reign year of the King Rama X is in 1946
"""
if int(reign) == 10:
ad = int(reign_year) + 2015
elif int(reign) == 9:
ad = int(reign_year) + 1945
elif int(reign) == 8:
ad = int(reign_year) + 1928
elif int(reign) == 7:
ad = int(reign_year) + 1924
return ad