275 lines
11 KiB
Objective-C
Executable File
275 lines
11 KiB
Objective-C
Executable File
//
|
||
// BRDatePickerView.h
|
||
// BRPickerViewDemo
|
||
//
|
||
// Created by renbo on 2017/8/11.
|
||
// Copyright © 2017 irenb. All rights reserved.
|
||
//
|
||
// 最新代码下载地址：https://github.com/91renb/BRPickerView
|
||
|
||
#import "BRBaseView.h"
|
||
#import "NSDate+BRPickerView.h"
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
/// 日期选择器格式
|
||
typedef NS_ENUM(NSInteger, BRDatePickerMode) {
|
||
// ----- 以下4种是系统样式（兼容国际化日期格式） -----
|
||
/** 【yyyy-MM-dd】UIDatePickerModeDate（美式日期：MM-dd-yyyy；英式日期：dd-MM-yyyy）*/
|
||
BRDatePickerModeDate,
|
||
/** 【yyyy-MM-dd HH:mm】 UIDatePickerModeDateAndTime */
|
||
BRDatePickerModeDateAndTime,
|
||
/** 【HH:mm】UIDatePickerModeTime */
|
||
BRDatePickerModeTime,
|
||
/** 【HH:mm】UIDatePickerModeCountDownTimer */
|
||
BRDatePickerModeCountDownTimer,
|
||
|
||
// ----- 以下14种是自定义样式 -----
|
||
/** 【yyyy-MM-dd HH:mm:ss】年月日时分秒 */
|
||
BRDatePickerModeYMDHMS,
|
||
/** 【yyyy-MM-dd HH:mm】年月日时分 */
|
||
BRDatePickerModeYMDHM,
|
||
/** 【yyyy-MM-dd HH】年月日时 */
|
||
BRDatePickerModeYMDH,
|
||
/** 【MM-dd HH:mm】月日时分 */
|
||
BRDatePickerModeMDHM,
|
||
/** 【yyyy-MM-dd】年月日（兼容国际化日期：dd-MM-yyyy）*/
|
||
BRDatePickerModeYMD,
|
||
/** 【yyyy-MM】年月（兼容国际化日期：MM-yyyy）*/
|
||
BRDatePickerModeYM,
|
||
/** 【yyyy】年 */
|
||
BRDatePickerModeY,
|
||
/** 【MM-dd】月日 */
|
||
BRDatePickerModeMD,
|
||
/** 【HH:mm:ss】时分秒 */
|
||
BRDatePickerModeHMS,
|
||
/** 【HH:mm】时分 */
|
||
BRDatePickerModeHM,
|
||
/** 【mm:ss】分秒 */
|
||
BRDatePickerModeMS,
|
||
|
||
/** 【yyyy-qq】年季度 */
|
||
BRDatePickerModeYQ,
|
||
/** 【yyyy-MM-ww】年月周 */
|
||
BRDatePickerModeYMW,
|
||
/** 【yyyy-ww】年周 */
|
||
BRDatePickerModeYW
|
||
};
|
||
|
||
/// 日期单位显示的位置
|
||
typedef NS_ENUM(NSInteger, BRShowUnitType) {
|
||
/** 日期单位显示全部行（默认）*/
|
||
BRShowUnitTypeAll,
|
||
/** 日期单位仅显示中间行 */
|
||
BRShowUnitTypeOnlyCenter,
|
||
/** 日期单位不显示（隐藏日期单位）*/
|
||
BRShowUnitTypeNone
|
||
};
|
||
|
||
typedef void (^BRDateResultBlock)(NSDate * _Nullable selectDate, NSString * _Nullable selectValue);
|
||
|
||
typedef void (^BRDateResultRangeBlock)(NSDate * _Nullable selectStartDate, NSDate * _Nullable selectEndDate, NSString * _Nullable selectValue);
|
||
|
||
@interface BRDatePickerView : BRBaseView
|
||
|
||
/**
|
||
//////////////////////////////////////////////////////////////////////////
|
||
///
|
||
/// 【用法一】
|
||
/// 特点：灵活，扩展性强（推荐使用！）
|
||
///
|
||
////////////////////////////////////////////////////////////////////////*/
|
||
|
||
/** 日期选择器显示类型 */
|
||
@property (nonatomic, assign) BRDatePickerMode pickerMode;
|
||
|
||
/** 设置选中的日期（推荐使用 selectDate） */
|
||
@property (nullable, nonatomic, strong) NSDate *selectDate;
|
||
@property (nullable, nonatomic, copy) NSString *selectValue;
|
||
|
||
/** 最小日期（可使用 NSDate+BRPickerView 分类中对应的方法进行创建）*/
|
||
@property (nullable, nonatomic, strong) NSDate *minDate;
|
||
/** 最大日期（可使用 NSDate+BRPickerView 分类中对应的方法进行创建）*/
|
||
@property (nullable, nonatomic, strong) NSDate *maxDate;
|
||
|
||
/** 选择结果的回调 */
|
||
@property (nullable, nonatomic, copy) BRDateResultBlock resultBlock;
|
||
/** 选择结果范围的回调：for `BRDatePickerModeYQ`、`BRDatePickerModeYMW`、`BRDatePickerModeYW`, ignored otherwise. */
|
||
@property (nullable, nonatomic, copy) BRDateResultRangeBlock resultRangeBlock;
|
||
|
||
/** 滚动选择时触发的回调 */
|
||
@property (nullable, nonatomic, copy) BRDateResultBlock changeBlock;
|
||
/** 滚动选择范围时触发的回调：for `BRDatePickerModeYQ`、`BRDatePickerModeYMW`、`BRDatePickerModeYW`, ignored otherwise. */
|
||
@property (nullable, nonatomic, copy) BRDateResultRangeBlock changeRangeBlock;
|
||
|
||
/** 日期单位显示类型 */
|
||
@property (nonatomic, assign) BRShowUnitType showUnitType;
|
||
|
||
/** 是否显示【星期】，默认为 NO */
|
||
@property (nonatomic, assign, getter=isShowWeek) BOOL showWeek;
|
||
|
||
/** 是否显示【今天】，默认为 NO */
|
||
@property (nonatomic, assign, getter=isShowToday) BOOL showToday;
|
||
|
||
/** 是否添加【至今】，默认为 NO */
|
||
@property (nonatomic, assign, getter=isAddToNow) BOOL addToNow;
|
||
|
||
/** 首行添加【自定义字符串】，配合 selectValue 可设置默认选中 */
|
||
@property (nullable, nonatomic, copy) NSString *firstRowContent;
|
||
|
||
/** 末行添加【自定义字符串】，配合 selectValue 可设置默认选中 */
|
||
@property (nullable, nonatomic, copy) NSString *lastRowContent;
|
||
|
||
/** 最后一行，添加【自定义字符串】 */
|
||
@property (nullable, nonatomic, copy) NSString *addCustomString DEPRECATED_MSG_ATTRIBUTE("Use 'lastRowContent' instead");
|
||
|
||
/** 滚轮上日期数据排序是否降序，默认为 NO（升序）*/
|
||
@property (nonatomic, assign, getter=isDescending) BOOL descending;
|
||
|
||
/** 选择器上数字是否带有前导零，默认为 NO（如：无前导零:2020-1-1；有前导零:2020-01-01）*/
|
||
@property (nonatomic, assign, getter=isNumberFullName) BOOL numberFullName;
|
||
|
||
/** 设置分的时间间隔，默认为1（范围：1 ~ 30）*/
|
||
@property (nonatomic, assign) NSInteger minuteInterval;
|
||
|
||
/** 设置秒的时间间隔，默认为1（范围：1 ~ 30）*/
|
||
@property (nonatomic, assign) NSInteger secondInterval;
|
||
|
||
/** 设置倒计时的时长，默认为0（范围：0 ~ 24*60*60-1，单位为秒） for `BRDatePickerModeCountDownTimer`, ignored otherwise. */
|
||
@property (nonatomic, assign) NSTimeInterval countDownDuration;
|
||
|
||
/**
|
||
* 自定义月份数据源
|
||
* 如：@[@"1月", @"2月",..., @"12月"]、 @[@"一月", @"二月",..., @"十二月"]、 @[@"Jan", @"Feb",..., @"Dec"] 等
|
||
*/
|
||
@property (nonatomic, copy) NSArray <NSString *> *monthNames;
|
||
|
||
/**
|
||
* 设置国际化日期(非中文环境下)月份是否显示简称，默认为 NO。for `BRDatePickerModeYMD` and `BRDatePickerModeYM`, ignored otherwise.
|
||
* 如：January 的简称为：Jan
|
||
*/
|
||
@property (nonatomic, assign, getter=isShortMonthName) BOOL shortMonthName;
|
||
|
||
/**
|
||
* 自定义日期单位
|
||
* 字典格式：@{@"year": @"年", @"month": @"月", @"day": @"日", @"hour": @"时", @"minute": @"分", @"second": @"秒"}
|
||
*/
|
||
@property (nonatomic, copy) NSDictionary *customUnit;
|
||
|
||
/** 显示上午和下午，默认为 NO. for `BRDatePickerModeYMDH`, ignored otherwise. */
|
||
@property (nonatomic, assign, getter=isShowAMAndPM) BOOL showAMAndPM;
|
||
|
||
/** 设置时区，默认为当前时区 */
|
||
@property (nullable, nonatomic, copy) NSTimeZone *timeZone;
|
||
|
||
/** default is [NSCalendar currentCalendar]. setting nil returns to default. for `UIDatePicker` */
|
||
@property (nonatomic, copy) NSCalendar *calendar;
|
||
|
||
/** 指定不允许选择的日期 */
|
||
@property (nullable, nonatomic, copy) NSArray <NSDate *> *nonSelectableDates;
|
||
|
||
/** 不允许选择日期的回调 */
|
||
@property (nullable, nonatomic, copy) BRDateResultBlock nonSelectableBlock;
|
||
|
||
/// 初始化日期选择器
|
||
/// @param pickerMode 日期选择器显示类型
|
||
- (instancetype)initWithPickerMode:(BRDatePickerMode)pickerMode;
|
||
|
||
/// 弹出选择器视图
|
||
- (void)show;
|
||
|
||
/// 关闭选择器视图
|
||
- (void)dismiss;
|
||
|
||
|
||
|
||
|
||
//================================================= 华丽的分割线 =================================================
|
||
|
||
|
||
|
||
|
||
/**
|
||
//////////////////////////////////////////////////////////////////////////
|
||
///
|
||
/// 【用法二】：快捷使用，直接选择下面其中的一个方法进行使用
|
||
/// 特点：快捷，方便
|
||
///
|
||
////////////////////////////////////////////////////////////////////////*/
|
||
|
||
/**
|
||
* 1.显示日期选择器
|
||
*
|
||
* @param mode 日期显示类型
|
||
* @param title 选择器标题
|
||
* @param selectValue 默认选中的日期（默认选中当前日期）
|
||
* @param resultBlock 选择结果的回调
|
||
*
|
||
*/
|
||
+ (void)showDatePickerWithMode:(BRDatePickerMode)mode
|
||
title:(nullable NSString *)title
|
||
selectValue:(nullable NSString *)selectValue
|
||
resultBlock:(nullable BRDateResultBlock)resultBlock;
|
||
|
||
/**
|
||
* 2.显示日期选择器
|
||
*
|
||
* @param mode 日期显示类型
|
||
* @param title 选择器标题
|
||
* @param selectValue 默认选中的日期（默认选中当前日期）
|
||
* @param isAutoSelect 是否自动选择，即滚动选择器后就执行结果回调，默认为 NO
|
||
* @param resultBlock 选择结果的回调
|
||
*
|
||
*/
|
||
+ (void)showDatePickerWithMode:(BRDatePickerMode)mode
|
||
title:(nullable NSString *)title
|
||
selectValue:(nullable NSString *)selectValue
|
||
isAutoSelect:(BOOL)isAutoSelect
|
||
resultBlock:(nullable BRDateResultBlock)resultBlock;
|
||
|
||
/**
|
||
* 3.显示日期选择器
|
||
*
|
||
* @param mode 日期显示类型
|
||
* @param title 选择器标题
|
||
* @param selectValue 默认选中的日期（默认选中当前日期）
|
||
* @param minDate 最小日期（可使用 NSDate+BRPickerView 分类中对应的方法进行创建）
|
||
* @param maxDate 最大日期（可使用 NSDate+BRPickerView 分类中对应的方法进行创建）
|
||
* @param isAutoSelect 是否自动选择，即滚动选择器后就执行结果回调，默认为 NO
|
||
* @param resultBlock 选择结果的回调
|
||
*
|
||
*/
|
||
+ (void)showDatePickerWithMode:(BRDatePickerMode)mode
|
||
title:(nullable NSString *)title
|
||
selectValue:(nullable NSString *)selectValue
|
||
minDate:(nullable NSDate *)minDate
|
||
maxDate:(nullable NSDate *)maxDate
|
||
isAutoSelect:(BOOL)isAutoSelect
|
||
resultBlock:(nullable BRDateResultBlock)resultBlock;
|
||
|
||
/**
|
||
* 3.显示日期选择器
|
||
*
|
||
* @param mode 日期显示类型
|
||
* @param title 选择器标题
|
||
* @param selectValue 默认选中的日期（默认选中当前日期）
|
||
* @param minDate 最小日期（可使用 NSDate+BRPickerView 分类中对应的方法进行创建）
|
||
* @param maxDate 最大日期（可使用 NSDate+BRPickerView 分类中对应的方法进行创建）
|
||
* @param isAutoSelect 是否自动选择，即滚动选择器后就执行结果回调，默认为 NO
|
||
* @param resultBlock 选择结果的回调
|
||
* @param resultRangeBlock 范围选择结果的回调
|
||
*
|
||
*/
|
||
+ (void)showDatePickerWithMode:(BRDatePickerMode)mode
|
||
title:(nullable NSString *)title
|
||
selectValue:(nullable NSString *)selectValue
|
||
minDate:(nullable NSDate *)minDate
|
||
maxDate:(nullable NSDate *)maxDate
|
||
isAutoSelect:(BOOL)isAutoSelect
|
||
resultBlock:(nullable BRDateResultBlock)resultBlock
|
||
resultRangeBlock:(nullable BRDateResultRangeBlock)resultRangeBlock;
|
||
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END
|