Time 是一个 Swift 包,可以轻松执行稳健且类型安全日期和时间计算。
使用日历可能非常复杂且容易出错。Time 通过明确概念并通过类型安全的 API 限制不当使用来解决这些问题。
Time 可以像其他任何 Swift 包一样安装。将其添加到您的 Package.swift 文件的 dependencies
部分
.package(url: "https://github.com/davedelong/time", from: "1.0.0")
Time 需要 Swift 5.7 或更高版本,以及 macOS 13/iOS 16(或同等版本)或更高版本。 该库的核心部分构建在 Swift 的 Duration
类型之上,该类型是在 macOS 13/iOS 16 中引入的。
Time 的大量文档托管在 Swift Package Index 上。
此外,此存储库中的“Examples”文件夹包含说明如何使用该库核心部分的代码。
这是文档的 TL;DR 版本
如果您想知道现在几点,您需要设备的 RegionalClock
,可以通过使用 Clocks.system
来获取。
RegionalClock
会告诉您当前时间。 例如,.today
会给您当前的日历日。 .currentMinute
会给您当前的时间,精确到分钟级别。
这些返回的每个值都有方法来检索更多和更少精确的值。 例如,today.hours
将为您提供当天所有“小时”值的序列。
这些值可以通过它们的 .format(...)
方法格式化为人类可读的字符串。
有关更多信息,请参阅 文档 和包含的示例。
Time 是完全开源的,可在 https://github.com/davedelong/time 上获得。 如果您有功能请求、建议或发现错误,请打开 新的 issue。
Time 是在 MIT 许可证下获得许可的。 有关更多信息,请参阅 LICENSE 文件。