介绍

Arrow是一个Python库，它提供了一种合理且对人类友好的方法来创建、操作、格式化和转换日期、时间和时间戳。它实现了对datetime类型的更新，填补了功能上的空白，提供了一个智能的模块API，支持许多常见的创建场景。简单来说，它可以帮助您使用更少的导入和更少的代码来处理日期和时间。

Arrow以时间之箭命名，并且受到moment.js和requests的极大启发。

为什么要使用Arrow而不是内置模块？

Python的标准库和其他一些低级模块拥有近乎完整的日期、时间和时区功能，但从可用性的角度来看，它们的工作效果并不理想：

  • 模块太多：datetime, time, calendar, dateutil, pytz等

  • 类型太多：date, time, datetime, tzinfo, timedelta, relativedelta等

  • 时区和时间戳转换冗长且不愉快

  • 通常情况下都是时区不敏感的

  • 功能上存在gap：ISO 8601支持、时区间隔支持、不够人性化

特性

  • 完全实现的，可替代datetime

  • 支持Python 3.6+

  • 默认支持时区感知和UTC

  • 为许多常见输入场景提供超简单的创建选项

  • shift方法支持相对偏移，包括周

  • 自动格式化和解析字符串

  • 广泛支持ISO 8601标准

  • 时区转换

  • 支持dateutil, pytz和ZoneInfo tzinfo对象

  • 生成时间段、范围、下限和上限，适用于从微秒到年的时间框架

  • 使用不断增长的贡献语言环境人性化日期和时间

  • 可扩展为您自己的Arrow派生类型

  • 全面支持PEP 484风格的类型提示

快速开始

安装

使用 pip or pipenv:

pip install -U arrow

简单使用

>>> import arrow

>>> arrow.get('2024-06-13T17:23:58.970460+08:00')

<Arrow [2024-06-13T17:23:58.970460+08:00]>

>>> utc = arrow.utcnow()

>>> utc

<Arrow [2024-06-13T08:37:39.950050+00:00]>

>>> utc = utc.shift(hours=-1)

>>> utc

<Arrow [2024-06-13T07:37:39.950050+00:00]>

>>> local = utc.to('Asia/Shanghai')

>>> local

<Arrow [2024-06-13T15:37:39.950050+08:00]>

>>> local.timestamp()

1718264259.95005

>>> local.format()

'2024-06-13 15:37:39+08:00'

>>> local.format('YYYY-MM-DD HH:mm:ss ZZ')

'2024-06-13 15:37:39 +08:00'

>>> local.humanize()

'an hour ago'

>>> local.humanize(locale='zh-cn')

'1小时前'

用户指南

Creation（创建对象）

通过now方法创建：

>>> arrow.utcnow()

<Arrow [2024-06-13T09:03:42.591212+00:00]>

>>> arrow.now()

<Arrow [2024-06-13T17:04:00.926319+08:00]>

>>> arrow.now('Asia/Shanghai')

<Arrow [2024-06-13T17:04:25.058905+08:00]>

通过时间戳创建 (int or float):

>>> arrow.get(1718264259)

<Arrow [2024-06-13T07:37:39+00:00]>

>>> arrow.get(1718264259.95005)

<Arrow [2024-06-13T07:37:39.950050+00:00]>

使用无时区时间、有时区时间，或者灵活指定时区：

>>> arrow.get(datetime.utcnow())

<Arrow [2024-06-13T09:14:15.099808+00:00]>

>>> arrow.get(datetime(2024, 6, 13), 'Asia/Shanghai')

<Arrow [2024-06-13T00:00:00+08:00]>

>>> from dateutil import tz

>>> arrow.get(datetime(2024, 6, 13), tz.gettz('Asia/Shanghai'))

<Arrow [2024-06-13T00:00:00+08:00]>

>>> arrow.get(datetime.now(),tz.gettz('Asia/Shanghai'))

<Arrow [2024-06-13T17:16:02.309002+08:00]>

从字符串转换：

>>> arrow.get('2024-06-13 15:30:45', 'YYYY-MM-DD HH:mm:ss')

<Arrow [2024-06-13T15:30:45+00:00]>

从文本中查找日期：

>>> arrow.get('June was born in May 1980', 'MMMM YYYY')

<Arrow [1980-05-01T00:00:00+00:00]>

自动识别ISO 8601格式的字符串，并解析出相应的日期时间对象，包括时区信息：

>>> arrow.get('2024-06-13T15:34:00.000-08:00')

<Arrow [2024-06-13T15:34:00-08:00]>

直接实例化Arrow对象（使用datetime类一样的参数）：

>>> arrow.get(2024, 6, 13)

<Arrow [2024-06-13T00:00:00+00:00]>

>>>

>>> arrow.Arrow(2024, 6, 13)

<Arrow [2024-06-13T00:00:00+00:00]>

Properties（属性）

获取日期时间或时间戳表示形式：

>>> a = arrow.utcnow()

>>> a.datetime

datetime.datetime(2024, 6, 13, 9, 25, 1, 195217, tzinfo=tzutc())

获取一个原生的时间，包含tzinfo：

>>> a.naive

datetime.datetime(2024, 6, 13, 9, 25, 1, 195217)

>>> a.tzinfo

tzutc()

获取任意日期时间值：

>>> a.year

2024

>>> a.month

6

调用datetime类相关函数和属性：

>>> a.date()

datetime.date(2024, 6, 13)

>>> a.time()

datetime.time(9, 25, 1, 195217)

Replace & Shift（替换和偏移）

获取一个新的Arrow对象，更改其属性，就像处理datetime类型一样：

>>> arw = arrow.utcnow()

>>> arw

<Arrow [2024-06-13T09:33:30.538303+00:00]>

>>> arw.replace(hour=4, minute=40)

<Arrow [2024-06-13T04:40:30.538303+00:00]>

或者，将属性向前或向后移动的：

>>> arw.shift(weeks=+3)

<Arrow [2024-07-04T09:33:30.538303+00:00]>

>>> arw.shift(days=-3)

<Arrow [2024-06-10T09:33:30.538303+00:00]>

甚至，直接替换时区

>>> arw.replace(tzinfo='US/Pacific')

<Arrow [2024-06-13T09:33:30.538303-07:00]>

Format（格式化）

arrow.utcnow().format('YYYY-MM-DD HH:mm:ss ZZ')

'2024-06-13 09:34:54 +00:00'

Convert（转换）

按名称或tzinfo从UTC转换为其他时区：

>>> utc = arrow.utcnow()

>>> utc

<Arrow [2024-06-13T09:36:22.204239+00:00]>

>>> utc.to('US/Pacific')

<Arrow [2024-06-13T02:36:22.204239-07:00]>

>>> utc.to(tz.gettz('US/Pacific'))

<Arrow [2024-06-13T02:36:22.204239-07:00]>

或者使用简写：

>>> utc.to('local')

<Arrow [2024-06-13T17:36:22.204239+08:00]>

>>> utc.to('local').to('utc')

<Arrow [2024-06-13T09:36:22.204239+00:00]>

Humanize（人性化）

相对于现在时间的人性化表现：

>>> past = arrow.utcnow().shift(hours=-1)

>>> past.humanize()

'an hour ago'

或者另一个Arrow对下或日期时间：

>>> present = arrow.utcnow()

>>> future = present.shift(hours=2)

>>> future.humanize(present)

'in 2 hours'

将时间表示为相对时间或仅包括时间距离：

>>> present = arrow.utcnow()

>>> future = present.shift(hours=2)

>>> future.humanize(present)

'in 2 hours'

>>> future.humanize(present, only_distance=True)

'2 hours'

指定特定的时间粒度（或多个）：

>>> present = arrow.utcnow()

>>> future = present.shift(minutes=66)

>>> future.humanize(present, granularity="minute")

'in 66 minutes'

>>> future.humanize(present, granularity=["hour", "minute"])

'in an hour and 6 minutes'

>>> present.humanize(future, granularity=["hour", "minute"])

'an hour and 6 minutes ago'

>>> future.humanize(present, only_distance=True, granularity=["hour", "minute"])

'an hour and 6 minutes'

支持不同时区的语言显示：

>>> future = arrow.utcnow().shift(hours=1)

>>> future.humanize(a, locale='ru')

'через час'

>>> future.humanize(a, locale='zh-cn')

'1小时后'

Dehumanize（去人性化）

使用人类可读的字符串描述，并使用它转换到过去的时间：

>>> arw = arrow.utcnow()

>>> arw

<Arrow [2024-06-13T09:47:35.616633+00:00]>

>>> earlier = arw.dehumanize("2 days ago")

>>> earlier

<Arrow [2024-06-11T09:47:35.616633+00:00]>

或者用它来转换到未来的时间：

>>> arw = arrow.utcnow()

>>> arw

<Arrow [2024-06-13T09:47:35.616633+00:00]>

>>> later = arw.dehumanize("in a month")

>>> later

<Arrow [2024-07-13T09:47:35.616633+00:00]>

支持不同时区的语言转换：

>>> later = arw.dehumanize('1小时后', locale="zh-cn")

>>> later

<Arrow [2024-06-13T10:47:35.616633+00:00]>

Ranges & Spans（范围&跨度）

获取任意单位的时间跨度：

>>> arrow.utcnow().span('hour')

(<Arrow [2024-06-13T09:00:00+00:00]>, <Arrow [2024-06-13T09:59:59.999999+00:00]>)

>>> arrow.utcnow().span('day')

(<Arrow [2024-06-13T00:00:00+00:00]>, <Arrow [2024-06-13T23:59:59.999999+00:00]>)

或者只获取最大最小值：

>>> arrow.utcnow().floor('hour')

<Arrow [2024-06-13T09:00:00+00:00]>

>>> arrow.utcnow().ceil('hour')

<Arrow [2024-06-13T09:59:59.999999+00:00]>

您还可以获取一系列时间跨度：

>>> start = datetime(2024, 6, 13, 12, 30)

>>> end = datetime(2024, 6, 13, 17, 15)

>>> for r in arrow.Arrow.span_range('hour', start, end):

...     print(r)

...

(<Arrow [2024-06-13T12:00:00+00:00]>, <Arrow [2024-06-13T12:59:59.999999+00:00]>)

(<Arrow [2024-06-13T13:00:00+00:00]>, <Arrow [2024-06-13T13:59:59.999999+00:00]>)

(<Arrow [2024-06-13T14:00:00+00:00]>, <Arrow [2024-06-13T14:59:59.999999+00:00]>)

(<Arrow [2024-06-13T15:00:00+00:00]>, <Arrow [2024-06-13T15:59:59.999999+00:00]>)

(<Arrow [2024-06-13T16:00:00+00:00]>, <Arrow [2024-06-13T16:59:59.999999+00:00]>)

(<Arrow [2024-06-13T17:00:00+00:00]>, <Arrow [2024-06-13T17:59:59.999999+00:00]>)

或者只是获取一系列时间点：

>>> start = datetime(2024, 6, 13, 12, 30)

>>> end = datetime(2024, 6, 13, 17, 15)

>>> for r in arrow.Arrow.range('hour', start, end):

...     print(repr(r))

...

<Arrow [2024-06-13T12:30:00+00:00]>

<Arrow [2024-06-13T13:30:00+00:00]>

<Arrow [2024-06-13T14:30:00+00:00]>

<Arrow [2024-06-13T15:30:00+00:00]>

<Arrow [2024-06-13T16:30:00+00:00]>

Factories（工厂方法）

使用工厂模式实现自定义Arrow派生类型，来继承和扩展Arrow的模块API。首先，定义您的类型：

class CustomArrow(arrow.Arrow):

...

...     def days_till_xmas(self):

...         xmas = arrow.Arrow(self.year, 12, 25)

...         if self > xmas:

...             xmas = xmas.shift(years=1)

...         return (xmas - self).days

然后使用工厂：

>>> factory = arrow.ArrowFactory(CustomArrow)

>>> custom = factory.utcnow()

>>> custom

<CustomArrow [2024-06-13T10:02:04.898347+00:00]>

>>> custom.days_till_xmas()

194

Supported Tokens（支持的格式）

使用以下标记进行分析和格式化。请注意，它们与strptime的标记不同：

  标记格式 示例
Year YYYY 2000, 2001, 2002 … 2012, 2013
  YY 00, 01, 02 … 12, 13
Month MMMM January, February, March …1
  MMM Jan, Feb, Mar …1
  MM 01, 02, 03 … 11, 12
  M 1, 2, 3 … 11, 12
Day of Year DDDD 001, 002, 003 … 364, 365
  DDD 1, 2, 3 … 364, 365
Day of Month DD 01, 02, 03 … 30, 31
  D 1, 2, 3 … 30, 31
  Do 1st, 2nd, 3rd … 30th, 31st
Day of Week dddd Monday, Tuesday, Wednesday …2
  ddd Mon, Tue, Wed …2
  d 1, 2, 3 … 6, 7
ISO week date W 2011-W05-4, 2019-W17
Hour HH 00, 01, 02 … 23, 24
  H 0, 1, 2 … 23, 24
  hh 01, 02, 03 … 11, 12
  h 1, 2, 3 … 11, 12
AM / PM A AM, PM, am, pm1
  a am, pm1
Minute mm 00, 01, 02 … 58, 59
  m 0, 1, 2 … 58, 59
Second ss 00, 01, 02 … 58, 59
  s 0, 1, 2 … 58, 59
Sub-second S… 0, 02, 003, 000006, 123123123123…3
Timezone ZZZ Asia/Baku, Europe/Warsaw, GMT …4
  ZZ -07:00, -06:00 … +06:00, +07:00, +08, Z
  Z -0700, -0600 … +0600, +0700, +08, Z
Seconds Timestamp X 1381685817, 1381685817.915482 …5
ms or µs Timestamp x 1569980330813, 1569980330813221

Built-in Formats（内置格式）

>>> arw = arrow.utcnow()

>>> arw.format(arrow.FORMAT_ATOM)

'2024-06-13 10:05:40+00:00'

>>> arw.format(arrow.FORMAT_COOKIE)

'Thursday, 13-Jun-2024 10:05:40 UTC'

>>> arw.format(arrow.FORMAT_RSS)

'Thu, 13 Jun 2024 10:05:40 +0000'

>>> arw.format(arrow.FORMAT_RFC822)

'Thu, 13 Jun 24 10:05:40 +0000'

>>> arw.format(arrow.FORMAT_RFC850)

'Thursday, 13-Jun-24 10:05:40 UTC'

>>> arw.format(arrow.FORMAT_RFC1036)

'Thu, 13 Jun 24 10:05:40 +0000'

>>> arw.format(arrow.FORMAT_RFC1123)

'Thu, 13 Jun 2024 10:05:40 +0000'

>>> arw.format(arrow.FORMAT_RFC2822)

'Thu, 13 Jun 2024 10:05:40 +0000'

>>> arw.format(arrow.FORMAT_RFC3339)

'2024-06-13 10:05:40+00:00'

>>> arw.format(arrow.FORMAT_W3C)

'2024-06-13 10:05:40+00:00'

Escaping Formats（转义格式）

解析和格式化时，可以通过将格式字符串中的标记、短语和正则表达式括在方括号中来转义它们。

标记格式

>>> fmt = "YYYY-MM-DD h [h] m"

>>> arw = arrow.get("2024-06-13 8 h 40", fmt)

>>> arw.format(fmt)

'2024-06-13 8 h 40'

>>> fmt = "YYYY-MM-DD h [hello] m"

>>> arw = arrow.get("2024-06-13 8 hello 40", fmt)

>>> arw

<Arrow [2024-06-13T08:40:00+00:00]>

>>> arw.format(fmt)

'2024-06-13 8 hello 40'

>>> fmt = "YYYY-MM-DD h [hello world] m"

>>> arw = arrow.get("2024-05-16 8 hello world 40", fmt)

>>> arw.format(fmt)

'2024-05-16 8 hello world 40'

正则

您还可以通过将正则表达式括在方括号内来转义它们。在下面的示例中，我们使用正则表达式s+来匹配分隔标记的任意数量的空白字符。如果您不提前知道令牌之间的空间数（例如，在日志文件中），这将非常有用。

>>> fmt = r"ddd[\s+]MMM[\s+]DD[\s+]HH:mm:ss[\s+]YYYY"

>>> arrow.get("Thu Jun 16 16:41:45 2024", fmt)

<Arrow [2024-06-16T16:41:45+00:00]>

>>> arrow.get("Thu \tJun 16     16:41:45        2024", fmt)

<Arrow [2024-06-16T16:41:45+00:00]>

>>> arrow.get("Thu Jun 16    16:41:45  2024", fmt)

<Arrow [2024-06-16T16:41:45+00:00]>

Punctuation（标点符号）

日期和时间格式的两侧可以用以下列表中的一个标点符号隔开：、.；：！" \ ' [ ] { } ( ) < >`

>>> arrow.get("Cool date: 2024-06-16T09:12:45.123456+04:30.", "YYYY-MM-DDTHH:mm:ss.SZZ")

<Arrow [2024-06-16T09:12:45.123456+04:30]>

>>> arrow.get("Tomorrow (2024-06-16) is Halloween!", "YYYY-MM-DD")

<Arrow [2024-06-16T00:00:00+00:00]>

>>> arrow.get("Halloween is on 2024.06.16.", "YYYY.MM.DD")

<Arrow [2024-06-16T00:00:00+00:00]>

>>> arrow.get("It's Halloween tomorrow (2024-06-16)!", "YYYY-MM-DD")

Traceback (most recent call last):

  File "<stdin>", line 1, in <module>

  File "C:\Users\LocalCache\local-packages\Python312\site-packages\arrow\api.py", line 91, in get

    return _factory.get(*args, **kwargs)

           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

  File "C:\Users\LocalCache\local-packages\Python312\site-packages\arrow\factory.py", line 292, in get

    dt = parser.DateTimeParser(locale).parse(

         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

  File "C:\Users\LocalCache\local-packages\Python312\site-packages\arrow\parser.py", line 323, in parse

    raise ParserMatchError(

arrow.parser.ParserMatchError: Failed to match 'YYYY-MM-DD' when parsing "It's Halloween tomorrow (2024-06-16)!".

Redundant Whitespace（冗余空白字符处理）

多余的空白字符（空格、制表符和换行符）可以通过将normalize_whitespace标志传递到arrow.get来自动规范化：

>>> arrow.get('\t \n  2024-06-13T12:30:45.123456 \t \n', normalize_whitespace=True)

<Arrow [2024-06-13T12:30:45.123456+00:00]>

>>> arrow.get('2024-06-13  T \n   12:30:45\t123456', 'YYYY-MM-DD T HH:mm:ss S', normalize_whitespace=True)

<Arrow [2024-06-13T12:30:45.123456+00:00]>

超越datetime：Arrow，Python中的日期时间管理大师的更多相关文章

  1. Python中处理日期时间库的使用方法（转载）

    <本文来自公众号“大邓带你玩python”,转载> 用百分之20时间,学会解决百分之80的问题. 常用的库有time.datetime.其中datetime库是对time库的封装,所以使用 ...

  2. Python中处理日期时间库的使用方法

    常用的库有time.datetime.其中datetime库是对time库的封装,所以使用起来更加便捷.date是指日期时间(年月日)处理,time往往更加细小的单位(小时分秒等)的时间处理. 一.d ...

  3. C#中用DateTime的ParseExact方法解析日期时间（excel中使用系统默认的日期格式）

    最近做的项目中服务器是英文的系统,系统需要通过excel的单元格导入日期,excel中的日期格式是系统默认的日期格式,如下图所示 以上日期格式,会跟着操作系统设置的日期格式相同例如我的中文系统的日期格 ...

  4. python中常用的时间操作

    python中常用的时间模块有time和datetime,以下是这两个模块中常用的方法: #先引入模块 import timefrom datetime import datetiem, timezo ...

  5. Android中关于日期时间与时区的使用总结

    在开发Android的过程中,出现过几次由于日期时间导致的问题,而且主要是由于时区的原因导致,所以一直想总结一下,形成一个良好的开发规范.   一.Unix时间戳   Unix时间戳(Unix tim ...

  6. 在mysql数据库中关于日期时间字段的处理

    在mysql数据库中关于日期时间字段的处理 在开发中,日期时间字段一般有如下几种设计 假设要获取2013-08-15日到2013-08-16日之间的记录 1. 直接使用日期时间类字段 相关sql语句如 ...

  7. 6.Python中内存是如何管理的？

    Python中内存是如何管理的? Python memory is managed by Python private heap space. All Python objects and data ...

  8. 想做时间管理大师？你可以试试Mybatis Plus代码生成器

    1. 前言 对于写Crud的老司机来说时间非常宝贵,一些样板代码写不但费时费力,而且枯燥无味.经常有小伙伴问我,胖哥你怎么天天那么有时间去搞新东西,透露一下秘诀呗. 好吧,今天就把Mybatis-pl ...

  9. Python中的日期和时间

    感觉C语言作为一门编程的入门语言还是很好的,相比较之下,Python为代表的一些语言,适合很多非计算机专业的编程入门学习. Python 日期和时间 Python 程序能用很多方式处理日期和时间,转换 ...

  10. Python与SQLite日期时间函数的使法

    SQLite的时间函数跟Python的时间函数有些许差别,所以稍做记录,供自己以后查询. 网上有将SQLite官方WIKI内容翻译成中文的文章,大家有兴趣可以搜索一下,我这里单纯记录一下个人比较常用的 ...

随机推荐

  1. dotnet OpenXML 解析 PPT 图表 解析日期时间表示内容

    在 OpenXML 里的图表存放的日期时间很多存放的是数值,需要进行转换才能获取到用户可见的字符串 日期在 OpenXML 里可以使用数值存放,需要根据数值和格式化字符串转换为用户可见的字符串 如以下 ...

  2. ASP.NET CORE 发布时不编译Views文件夹

    .net core 3.0正式版已经发布,目前整体相对来说已经稳定了,可以进行生产开发. 发布时默认情况下Views是直接编译成DLL文件(XXXXXX.Views.dll),日常开发维护过程中,经常 ...

  3. Flink Forward #Asia2020 流批一体及数仓资料整理

    阿里云实时计算负责人 - 王峰(莫问)/ FFA_2020-Flink as a Unified Engine - Now and Next-V4 2020年Flink 基于Flink 的流批一体数仓 ...

  4. windows系统桌面壁纸切换的三种csharp办法，兼容win10及旧版，还有一个现成桌面小程序

    我自己用这些代码做的小app如下: 最新版本已经改成了服务的方式,也可以选择性添加系统的右键菜单,并且我自己使用的源码库已经开源到了nuget,大家可以直接拿来做二次开发, 新版的下载地址为:http ...

  5. SQL函数详解SUM\COUNT\AVG......

    朋友们,个人公众号:SQL数据库运维 移动端的学习分享,各种数据库基础知识,一起进步,共同学习,期待你的加入. 函数的类型 1.聚合函数:对一组值执行计算,并返回单个值,也被称为组函数.聚合函数经常与 ...

  6. kettle使用4-使用Pan.bat执行转换、Kitchen.bat执行作业

    一.直接在spoon中执行作业 使用bat文件执行速度比执行在spoon.bat中执行慢很多,如果少数几个任务,可以直接在spoon中执行. 1.新建作业 2.在通用中,新建START 任务执行的时间 ...

  7. Win10-常用cmd命令与快捷键

    以下全部是本人私认为平时经常用到的指令,持续更行中- 常用快捷键 win + R : 输入cmd回车,打开命令提示符界面 win + E : 打开文件资源管理器(俗称:文件夹) win + S : 搜 ...

  8. CentOS7 防火墙（firewall）的命令详解

    复制代码 安装:yum install firewalld 1.firewalld的基本使用 启动: systemctl start firewalld 查看状态: systemctl status ...

  9. C#利用win32API创建窗体

    效果图 代码实现 1 using System; 2 using System.Runtime.InteropServices; 3 //using System.Windows.Forms; 4 5 ...

  10. 什么是Java线程池

    摘自:某个百度知道 多线程技术主要解决处理器单元内多个线程执行的问题,它可以显著减少处理器单元的闲置时间,增加处理器单元的吞吐能力. 假设一个服务器完成一项任务所需时间为:T1 创建线程时间,T2 在 ...