用于显示日期的 UILabel 子类。默认情况下，KLSDateLabel 将使用相对描述（“9分钟前”，“从现在起16小时”等）来显示当前日期7天内的日期（此行为可以禁用）。对于这个范围之外的日期，将使用日期格式化器将日期转换为文本。默认日期格式化器使用长日期格式且不包括时间。

使用方法

基本使用

与提供 NSString 作为标签文本（如同使用 UILabel 一样）不同，KLSDateLabel 使用 NSDate 实例来生成标签文本

KLSDateLabel *dateLabel = [[KLSDateLabel alloc] initWithFrame:CGRectMake(20, 20, 280, 40)];
dateLabel.date = [NSDate date];

高级使用

可以通过修改可用的属性来自定义 KLSDateLabel 的行为。请查看文档了解更多信息。

文档

通过 CocoaPods 安装 KLSDateLabel 时，文档会安装到 Xcode 的文档查看器中。文档也在线上提供，可在 CocoaDocs 查找。如果您不使用 CocoaPods，可以通过安装 appledoc 并运行以下命令手动安装文档：

$ appledoc -p KLSDateLabel -c "Keivn Stock" --company-id com.tantalic KLSDateLabel/*.h

安装

推荐使用 CocoaPods 依赖管理器来使用 KLSDateLabel。

1. 安装 CocoaPods（如果尚未安装）

2. 在您的 Xcode 项目文件同一目录下创建您的项目 Podfile

   $ touch Podfile

3. 将以下行添加到 Podfile 中

   pod 'KLSDateLabel', '~> 0.0'

4. 更新（或创建）

   $ pod install

5. 始终打开 Xcode 工作区（.xcworkspace），而不是项目文件来工作

要求

如果您选择直接使用源文件，则需要满足以下要求。

iOS 5.0 或更高版本

KLSDateLabel 只在 iOS 5.0 及更高版本上进行了测试。它可能与之前版本兼容，但并不推荐。

自动引用计数（ARC）

KLSDateLabel 需要使用 ARC。要在非ARC项目中使用 KLSDateLabel，您需要在 KLSDateLabel.m 文件中设置 -fobjc-arc 编译器标志。要在 Xcode 中设置此编译器标志，请转到您的活动目标并选择“构建阶段”选项卡。展开“编译源代码”阶段，双击 KLSDateLabel.m 文件。输入 -fobjc-arc 并点击“完成”。

TTTLocalizedPluralString

KLSDateLabel 使用 TTTLocalizedPluralString 处理本地化字符串。TTTLocalizedPluralString 宏的工作原理与 NSLocalizedString 宏类似，但添加了一个计数参数。

许可

KLSDateLabel 在 MIT 许可下提供。有关更多信息，请参阅 LICENSE 文件。