时间
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" 文件夹包含演示如何使用库核心部分的代码。
基础知识
以下是文档的简要概述:
-
如果你想知道当前时间,你需要设备的
RegionalClock
,可以通过使用Clocks.system
获取。 -
RegionalClock
告诉你当前时间。例如,.today
将给你当前日历日。.currentMinute
将给你精确到分钟级别的当前时间。 -
这些返回的值都有方法来检索更精确和更粗略的值。例如,
today.hours
将给你一天中所有 "Hour" 值的序列。 -
这些值可以通过它们的
.format(...)
方法格式化为人类可读的字符串。
有关更多信息,请参阅文档和包含的示例。
贡献
Time 完全开源,可在 https://github.com/davedelong/time 获取。如果你有功能请求、建议或发现了 bug,请开启一个新的 issue。
许可证
Time 基于 MIT 许可证授权。有关更多信息,请参阅 LICENSE 文件。