jdatetime

Jalali datetime binding for python

Project description

jdatetime is Jalali implementation of Python’s datetime module

Status

https://travis-ci.org/slashmili/python-jalali.svg?branch=master

https://img.shields.io/pypi/v/jdatetime.svg

Install

pip install jdatetime

Documents

This module exactly follows Python Standard datetime module’s methods http://docs.python.org/release/2.7.1/library/datetime.html

Also these methods are addedd to jdatetime.date and jdatetime.datetime :

fromgregorian(**kw)
    Convert gregorian to jalali and return jdatetime.date
    jdatetime.date.fromgregorian(day=X,month=X,year=X)
    jdatetime.date.fromgregorian(date=datetime.date)
    jdatetime.date.fromgregorian(datetime=datetime.datetime)
togregorian(self)
    Convert current jalali date to gregorian and return datetime.date
isleap(self)
    check if year is leap year
    algortim is based on http://en.wikipedia.org/wiki/Leap_year

Example

$ python
Python 2.6.6 (r266:84292, Sep 15 2010, 15:52:39)
[GCC 4.4.5] on linux2
Type "help", "copyright", "credits" or "license" for more information.
(InteractiveConsole)
>>> import jdatetime
>>> jdatetime.datetime.now()
jdatetime.datetime(1394, 12, 4, 8, 37, 31, 855729)
>>> jdatetime.date.today()
jdatetime.date(1394, 12, 4)

Locale

In order to get the date string in farsi you need to set the locale to fa_IR

$ python
Python 2.7.9 (default, Mar  1 2015, 12:57:24)
[GCC 4.9.2] on linux2
Type "help", "copyright", "credits" or "license" for more information.
(InteractiveConsole)
>>> import locale
>>> import jdatetime
>> jdatetime.datetime.now().strftime("%a, %d %b %Y %H:%M:%S")
u'Wed, 08 Ord 1395 20:47:32'
>>> locale.setlocale(locale.LC_ALL, "fa_IR")
'fa_IR'
>>> jdatetime.datetime.now().strftime("%a, %d %b %Y %H:%M:%S")
u'\u0686\u0647\u0627\u0631\u0634\u0646\u0628\u0647, 08 \u0627\u0631\u062f\u06cc\u0628\u0647\u0634\u062a 1395 20:47:56'

If your requirements demand to support different locales withing the same process, you could set the default locale per thread. New date and datetime instances created in each thread, will use the specified locale by default. This supports both Python threads, and greenlets.

import jdatetime
jdatetime.set_locale('fa_IR')
jdatetime.datetime.now().strftime('%A %B')
# u'\u062f\u0648\u0634\u0646\u0628\u0647 \u062e\u0631\u062f\u0627\u062f'

Project details

Release history Release notifications | RSS feed

5.0.0

Mar 26, 2024

4.1.1

Mar 28, 2023

4.1.0

Mar 22, 2022

4.0.0

Feb 14, 2022

3.8.2

Jan 24, 2022

3.8.1

Jan 17, 2022

3.8.0

Jan 7, 2022

3.7.0

Dec 20, 2021

3.6.4

Sep 23, 2021

3.6.2

Oct 24, 2019

3.6.1

Sep 19, 2019

3.6.0

Sep 10, 2019

3.5.0

Aug 6, 2019

3.4.0

Jul 16, 2019

3.3.0

Jul 13, 2019

3.2.0

Feb 2, 2019

3.1.0

Nov 25, 2018

3.0.2

Sep 2, 2018

3.0.0

Jul 22, 2018

This version

2.2.1

Jul 22, 2018

2.2.0

Jul 7, 2018

2.1.0

Jun 20, 2018

2.0.0

Feb 25, 2018

1.9.1

Feb 17, 2018

1.9.0

Aug 7, 2017

1.8.2

Feb 16, 2017

1.8.1

Apr 29, 2016

1.8.0

Apr 27, 2016

1.7.5

Apr 25, 2016

1.7.4

Feb 23, 2016

1.7.3

Feb 23, 2016

1.7.2

Jan 18, 2016

1.7.1

Oct 5, 2015

1.7

Oct 4, 2015

1.6

Jun 27, 2015

1.5

Apr 30, 2015

1.4

Mar 4, 2015

1.3

Dec 4, 2012

1.2

Apr 2, 2012

1.1

Aug 3, 2011

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jdatetime-2.2.1.tar.gz (9.9 kB view details)

Uploaded Jul 22, 2018 Source

File details

Details for the file jdatetime-2.2.1.tar.gz.

File metadata

Download URL: jdatetime-2.2.1.tar.gz
Upload date: Jul 22, 2018
Size: 9.9 kB
Tags: Source
Uploaded using Trusted Publishing? No

File hashes

Hashes for jdatetime-2.2.1.tar.gz
Algorithm	Hash digest
SHA256	`030a47ad3acbde45cb03872e2c6415c675dbb4a82462302971e93076145b5096`
MD5	`42a3e657b10d71aff2b3c280bc178b03`
BLAKE2b-256	`4c50e5946fd8a0dc6af5c2d9a96d7d206fbf323703b51050384685f2b5f20409`