平台兼容性

日期时间选择器 DatePicker

介绍

一款高颜值、多场景的日期时间选择器,提供自定义颜色/格式/文案等。
该插件采用scss编译,如遇到样式/层级问题可以到源码修改。 如果对您有帮助,可以评论或赞赏一下,谢谢!
地址:Uni-App插件市场地址 | Gitee | Github

属性说明

属性 类型 默认值 说明
show Boolean false 是否显示
type String date 类型,可选值:date(日期)、time(时间)、datetime(日期时间)、range(日期范围)、rangetime(日期时间范围)
color String #409eff 选择控件的颜色
format String 自定义格式,参考下方格式说明
value String, Array 设置显示的值(如果用了format需要个format格式一致,否则需要标准的能被Date解析的字符串(time除外))
showSeconds Boolean false 是否显示秒(type为datetime/time时生效)
showHoliday Boolean true 是否显示公历节日
showTips Boolean false 是否显示提示文字(type为range/rangetime时生效)
beginText String 开始 开始文案(type为datetime/time时生效)
endText String 结束 结束文案(type为datetime/time时生效)
[@confirm ]() ConfirmObject 确认选择事件
[@cancel ]() Boolean 取消选择事件(接收一个false)

format

格式 含义
y
m
d
h
i
s

示例:yyyy/mm/dd hh:ii:ss => 2019/03/26 23:39

ConfirmObject

{
    value: ..., //当前选择的值(String/Array)
    date: ..., //当前所选值的原始Date对象
}

使用示例

<template>
    <view>
        <view class="test">
            <view>日期选择 - 示例</view>
            {{date}}
            <button type="primary" @click="onShowDatePicker('date')">选择日期</button>
            {{time}}
            <button type="primary" @click="onShowDatePicker('time')">选择时间</button>
            {{datetime}}
            <button type="primary" @click="onShowDatePicker('datetime')">选择日期时间</button>
            {{range[0]}} - {{range[1]}}
            <button type="primary" @click="onShowDatePicker('range')">选择日期范围</button>
            {{rangetime[0]}} - {{rangetime[1]}}
            <button type="primary" @click="onShowDatePicker('rangetime')">选择日期时间范围</button>
        </view>
        <mx-date-picker :show="showPicker" :type="type" :value="value" :show-tips="true" :begin-text="'入住'" :end-text="'离店'" :show-seconds="true" @confirm="ed" @cancel="ed" />
    </view>
</template>
<script>
    import MxDatePicker from "@/components/mx-datepicker/mx-datepicker.vue";
    export default {
        components: {
            MxDatePicker
        },
        data() {
            return {
                showPicker: false,
                date: '2019/01/01',
                time: '15:00:12',
                datetime: '2019/01/01 15:00:12',
                range: ['2019/01/01','2019/01/06'],
                rangetime: ['2019/01/08 14:00','2019/01/16 13:59'],
                type: 'rangetime',
                value: ''
            }
        },
        methods: {
            onShowDatePicker(type){//显示
                this.type = type;
                this.showPicker = true;
                this.value = this[type];
            },
            ed(e) {//选择
                this.showPicker = false;
                if(e) {
                    this[this.type] = e.value; 
                    //选择的值
                    console.log('value => '+ e.value);
                    //原始的Date对象
                    console.log('date => ' + e.date);
                }
            }
        }
    }
</script>
<style>
    .test{
        text-align: center;
        padding: 10px 0;
    }
    button{
        margin: 20upx;
        font-size: 28upx;
    }
</style>

动画演示

日期时间范围选择 日期时间选择 日期范围选择 日期选择 时间选择

特别说明

测试的可能不是很全面,如果有BUG或者更好的建议请在评论区反馈,谢谢支持!

更新日志

v2.1.0

  • 底层重写(支持新版编译器),用法与上一版本一致
  • 引入提示文字
  • 增加滑动切换月份(横向)
  • 调整了显示大小
  • 修复评论区反馈的bug(Gitee #IUUF0)

v2.0.0

  • 全新版本

v1.0.3

  • 优化时间选择(解决时间不能选择等问题)
  • 增加默认时间和显示动画
  • 之前的format属性更名为type

v1.0.1

  • 紧急修复被系统样式覆盖导致的兼容性问题

v1.0.0

  • 增加时间选择
  • 支持选择类型

v0.0.7

  • 完成日期选择

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问