sharpetronics/fixedcal
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

improved readme

Browse Source
This commit is contained in:
Pyry Lahtinen 2022-12-11 14:43:22 +00:00 committed by GitHub
parent bc12e9d9d7
commit 411217d97b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 25 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
README.md
View File

@ -4,7 +4,11 @@ Python package for international fixed calendar dates.
## What is that? ## What is that?
International fixed calendar is an alternative calendar system. It divides year into 13 even months by adding a month called Sol between June and July. Each month starts with Sunday and has exactly 28 days or 4 weeks. An additional _year day_ is added to the end of the year and it does not belong to any of the months and has no weekday. You can read more about IFC on [Wikipedia](https://en.wikipedia.org/wiki/International_Fixed_Calendar). International fixed calendar is an alternative calendar system.
It divides year into 13 even months by adding a month called Sol between June and July.
Each month starts with Sunday and has exactly 28 days or 4 weeks.
An additional _year day_ is added to the end of the year and it does not belong to any of the months and has no weekday.
You can read more about IFC on [Wikipedia](https://en.wikipedia.org/wiki/International_Fixed_Calendar).
## Usage ## Usage
@ -18,8 +22,8 @@ fixed_date = FixedDate.today()
# From native datetime # From native datetime
from datetime import datetime from datetime import datetime
feburary_seventh = datetime(2022, 2, 7) february_seventh = datetime(2022, 2, 7)
fixed_date = FixedDate(feburary_seventh) fixed_date = FixedDate(february_seventh)
# From day's ordinal in year # From day's ordinal in year
fixed_date = FixedDate(day_of_year=107, year=2022) fixed_date = FixedDate(day_of_year=107, year=2022)
@ -42,7 +46,6 @@ fixed_date.week_of_month # 4
fixed_date.weekday # 7 fixed_date.weekday # 7
fixed_date.week_of_year # 32 fixed_date.week_of_year # 32
fixed_date.year_quarter # 3 fixed_date.year_quarter # 3
``` ```
### Date's operations ### Date's operations
@ -64,7 +67,8 @@ jan_first < fixed_date # False
### Year day ### Year day
Year day is the day after the last of December and before the first of January. For that date, `FixedDate` gives the following property values. Year day is the day after the last of December and before the first of January.
For that date, `FixedDate` gives the following property values.
* `day_of_year` = 365 * `day_of_year` = 365
* `day_of_month` = 1 * `day_of_month` = 1