跳转到主要内容

管理财政日历的实用工具

项目描述

https://github.com/adamjstewart/fiscalyear/actions/workflows/style.yaml/badge.svg https://github.com/adamjstewart/fiscalyear/actions/workflows/tests.yaml/badge.svg https://codecov.io/gh/adamjstewart/fiscalyear/branch/master/graph/badge.svg https://readthedocs.org/projects/fiscalyear/badge/?version=latest https://badge.fury.io/py/fiscalyear.svg https://anaconda.org/conda-forge/fiscalyear/badges/version.svg https://img.shields.io/spack/v/py-torchgeo

概述

fiscalyear 是一个小型、轻量级的Python模块,提供了管理财政日历的实用工具。它设计为内置的 datetimecalendar 模块的扩展,增加了查询日期或datetime对象所属的财政年、财政季、财政月和财政日的功能。

基本用法

fiscalyear 提供了几个有用的类。

财年类

FiscalYear 类提供了一个对象来存储有关特定财年起始和结束的信息。

>>> from fiscalyear import *
>>> a = FiscalYear(2017)
>>> a.start
FiscalDateTime(2016, 10, 1, 0, 0)
>>> a.end
FiscalDateTime(2017, 9, 30, 23, 59, 59)
>>> a.isleap
False

您也可以通过以下方式获取当前的 FiscalYear

>>> FiscalYear.current()
FiscalYear(2018)

财季类

FiscalYear 类还允许您查询有关特定财季的信息。

>>> a.q3.start
FiscalDateTime(2017, 4, 1, 0, 0)
>>> a.q3.end
FiscalDateTime(2017, 6, 30, 23, 59, 59)

这些对象代表独立的 FiscalQuarter 类。

>>> b = FiscalQuarter(2017, 3)
>>> b.start
FiscalDateTime(2017, 4, 1, 0, 0)
>>> b.end
FiscalDateTime(2017, 6, 30, 23, 59, 59)
>>> a.q3 == b
True
>>> b in a
True
>>> b.next_fiscal_quarter
FiscalQuarter(2017, 4)

您也可以通过以下方式获取当前的 FiscalQuarter

>>> FiscalQuarter.current()
FiscalQuarter(2018, 2)

财月类

FiscalMonth 类允许您跟踪财月。

>>> c = FiscalMonth(2017, 9)
>>> c.start
FiscalDateTime(2017, 6, 1, 0, 0)
>>> c.end
FiscalDateTime(2017, 6, 30, 23, 59, 59)
>>> c in a
True
>>> c in b
True
>>> c.next_fiscal_month
FiscalMonth(2017, 10)

您还可以通过以下方式获取当前会计月份

>>> FiscalMonth.current()
FiscalMonth(2018, 4)

会计日

为了跟踪会计日,请使用会计日类。

>>> d = FiscalDay(2017, 250)
>>> d.start
FiscalDateTime(2017, 6, 6, 0, 0)
>>> d.end
FiscalDateTime(2017, 6, 6, 23, 59, 59)
>>> d in a
True
>>> d in b
True
>>> d in c
True
>>> d.next_fiscal_day
FiscalDay(2017, 251)

您还可以通过以下方式获取当前会计日

>>> FiscalDay.current()
FiscalDay(2018, 94)

会计日期时间

上述每个对象的开始和结束都存储为会计日期时间类的实例。此类提供了与datetime类相同的所有功能,并增加了查询会计年、会计季度、会计月份和会计日的功能。

>>> e = FiscalDateTime.now()
>>> e
FiscalDateTime(2017, 4, 8, 20, 30, 31, 105323)
>>> e.fiscal_year
2017
>>> e.fiscal_quarter
3
>>> e.next_fiscal_quarter
FiscalQuarter(2017, 4)
>>> e.fiscal_month
7
>>> e.fiscal_day
190

会计日期

如果您不关心会计日期时间类的时间组件,那么会计日期类正是您所需要的。

>>> f = FiscalDate.today()
>>> f
FiscalDate(2017, 4, 8)
>>> f.fiscal_year
2017
>>> f.prev_fiscal_year
FiscalYear(2016)

安装

fiscalyear没有依赖项,使得它简单且易于安装。推荐使用pip安装fiscalyear

$ pip install fiscalyear

有关其他安装方法,请参阅安装文档

文档

文档托管在Read the Docs上。

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源代码分发

fiscalyear-0.4.0.tar.gz (8.8 kB 查看哈希值)

上传时间 源代码

构建分发

fiscalyear-0.4.0-py3-none-any.whl (8.4 kB 查看哈希值)

上传时间 Python 3

由以下机构支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面