whenever项目新增对float类型时间戳的支持

在时间处理库whenever的最新版本0.6.5中，开发团队为Instant.from_timestamp()方法新增了对浮点数(float)类型时间戳的支持。这一改进使得从其他时间处理库(如pendulum)迁移到whenever变得更加便捷。

背景与需求

许多现有的时间处理工具(如Python标准库的datetime和第三方库pendulum)在获取时间戳时，默认返回的是浮点数类型。例如，pendulum.DateTime.timestamp()方法就会返回一个浮点数值。然而，whenever库之前只支持整数类型的时间戳输入，这在迁移过程中造成了不便。

技术考量

whenever库的开发团队在做出这一改进时，考虑了以下几个技术因素：

1. 精度问题：虽然浮点数无法支持完整的纳秒级精度，但当时间戳已经是浮点数时，精度损失已经发生。因此，允许浮点数输入不会引入额外的精度问题。

2. 兼容性：这一改变使得whenever能够更好地与其他流行的时间处理库兼容，降低了用户的迁移成本。

3. 一致性：值得注意的是，whenever仍然保持timestamp()方法返回整数类型，这与现代时间处理库的做法一致，也避免了浮点数可能带来的精度损失问题。

使用方法

在新版本中，用户可以直接使用浮点数时间戳创建Instant对象：

from whenever import Instant
import pendulum

# 直接从pendulum获取浮点数时间戳
float_timestamp = pendulum.now().timestamp()

# 新版可以直接使用
instant = Instant.from_timestamp(float_timestamp)

对于仍在使用旧版本的用户，可以通过以下方式实现类似功能：

float_timestamp = pendulum.now().timestamp()
Instant.from_timestamp_nanos(int(float_timestamp * 1_000_000_000))

总结

whenever库的这一改进体现了开发者对用户体验的重视。通过支持浮点数时间戳输入，whenever在保持自身高性能和严格类型检查的同时，降低了用户从其他时间处理库迁移的门槛。这一变化使得whenever在时间处理领域的适用性更加广泛，也为开发者提供了更大的灵活性。