跳转到主要内容

以相对格式表示日期,因此,而不是'01/02/2012',它会显示为'4小时前'、'昨天'或'上周',这使大多数人更容易阅读和理解。

项目描述

生活、宇宙和一切

collective.prettydate 是一个帮助开发者解决在不同时区使用的网站上绝对日期格式化相关的一些可用性问题的一个包。

当一个日期被打印为“01/02/2012”时,它可能代表“2月1日”或“1月2日”,这取决于所使用的格式。此外,如果网站位于不同的时区,它可能会让你遇到今天日期被打印为昨天的,或者明天日期的情况。

collective.prettydate 以相对格式表示日期,因此它会显示为“4小时前”、“昨天”或“上周”,这对于大多数人来说更容易阅读和理解。

这个功能非常适合新闻网站或即将举办活动的网站。

大多数无害

Travis CI badge Coveralls badge Downloads

有想法吗?发现了错误吗?请通过打开支持票据告诉我们。

不要惊慌

此产品提供了一种将 DateTime 对象转换为人类可读文本的实用程序。

from zope.component import getUtility
from collective.prettydate.interfaces import IPrettyDate
date_utility = getUtility(IPrettyDate)

在此阶段,您可以使用“date”方法将 DateTime 对象转换为

from DateTime import DateTime
today = DateTime()
str_date = date_utility.date(today)

在上一个例子中,“str_date”将是“现在”

“date”方法还允许两个额外的参数:“short”和“asdays”,它们将修改输出以短格式(用“h”代替“hours”,“d”代替“days”等)和整个天数(它将使用“今天”代替任何秒、分钟或小时的当前天数)。它们两个都默认为“False”。

时区

如果您的服务器时区配置正确,并且 DateTime 对象包含有效的时区信息,则文本输出将反映正确的时间。您不需要在不同时区之间转换日期和时间。

输出示例

  • “4小时前”

  • “4h前”(短格式)

  • “28分钟后”

  • “6个月后”

  • “今天”

  • “上周”

  • “昨天”

  • “去年”

DateTime 3.0

collective.prettydate 与 DateTime 3.0 完全兼容,它提供了一个显著更小的内存占用。

安装

要在基于 buildout 的安装中启用此产品

  1. 编辑您的 buildout.cfg 并将 collective.prettydate 添加到要安装的 eggs 列表中

    [buildout]
    ...
    eggs =
        collective.prettydate

更新配置后,您需要运行“bin/buildout”,这将负责更新您的系统。

分享和享受

collective.prettydate 的实现离不开以下人员的贡献

  • Francesco Pellegrini

  • Héctor Velarde

  • Juan A. Díaz

您可以在 GitHub 上找到包贡献者的最新列表。

此包基于 py-pretty

由 Open Multimedia 赞助开发。

变更日志

因为你知道你的毛巾在哪里。

1.2.2 (2014-11-12)

  • 修复了德语翻译。[mbaechtold]

1.2.1 (2014-09-01)

  • 添加了德语翻译。[jone]

  • 修复了包依赖关系。[hvelarde]

1.2 (2013-03-19)

  • 添加了芬兰语翻译。[petri]

  • 添加了意大利语翻译。[gborelli]

  • 测试了与 Plone 4.3 的兼容性。[hvelarde]

  • 更新了文档。[hvelarde]

  • 测试了与 Plone 4.0 的兼容性。[hvelarde]

1.1 (2012-05-29)

  • 删除了未使用的测试模块。[hvelarde]

  • 删除了不必要的通用设置配置文件。[nueces]

  • 包不再依赖于 five.grok(修复 #3)。[frapell]

1.0 (2012-05-04)

  • 测试了与 Plone 4.2 的兼容性。[hvelarde]

  • 测试了与 DateTime 3.0 的兼容性,它提供了一个显著更小的内存占用。[hvelarde]

1.0rc1 (2012-02-21)

  • 初始发布。

项目详情


下载文件

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

源分布

collective.prettydate-1.2.2.zip (46.3 kB 查看散列值)

上传时间