Metadata-Version: 2.1
Name: jptime
Version: 0.1.1
Summary: handle japanese time format
Home-page: https://github.com/kitagawa-hr/jptime
Author: kitagawa-hr
Author-email: kitagawahr@gmail.com
Requires-Python: >=3.6,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Dist: japanese-numbers-python (>=0.2.0,<0.3.0)
Requires-Dist: python-dateutil (>=2.8.1,<3.0.0)
Project-URL: Repository, https://github.com/kitagawa-hr/jptime
Description-Content-Type: text/markdown

# jptime

jptime handle japanese time format.

## Installation

```sh
pip install jptime
```

## Usage

```py
from datetime import datetime
import jptime

# from string
jpt = jptime.from_str("平成元年三月三日")
assert jpt.to_tuple() == (4, 1, 3, 3)
assert jpt.to_datetime() == datetime(1989, 3, 3)

# from datetime
jpt = jptime.from_datetime(datetime(2019, 5, 1))
assert jpt.to_tuple() == (5, 1, 5, 1) # 令和1年5月1日
```

## Supported formats

- japanese era
  - era_symbol/yy/mm/dd (allow kanji number)
    (e.g. 昭和5年3月3日)
  - era_code + yymmdd
    (e.g. 3031123)
- christian era (delegate to dateutil.parser)
  (e.g. 19920323, 2018-12-12)

