获取某一天数据的方法–xmsCustomDate

概总

我们经常使用到的一个方法就是,获取指定某一天的数据,然后拼接成,想要展示的字符串,但是每次获取时,都要根据不同的需求,获取到不同的数据,比如当您要写一个日期插件时,就需要把日期,周,节日等,所以,就专门实现了该方法。

xmsCustomDate方法使用说明

  1. 基本介绍

    函数命名:xmsCustomDate

    函数调用:xmsCore.xmsCustomDate(option);

    参数:option介绍,请继续向下看。

  2. 基本架构

    该方法是完全的一个纯JS计算的方法,JS也是使用的原生的JS,不基于任何其他库。

  3. 传入参数option介绍

    参数option可为对象

    参数名 默认值 相关说明
    date(必须) “” 可以转换为时间的任意格式的参数
    length “” 返回的数组长度,如果不设置,那么返回date所在月份的正月的数据,同时包含上一月的结尾数据,和下一月的开始数据,正好几个周的数据。
    lineFirst 0 眉州以周几开始,默认为0,表示以周日开始每周

    如果想要以周一开始,那么设置为1,以此类推
  4. 返回值结构

    返回值是一个数组,数组中的每个元素(表示每一天),由以下属性组成。

    					
    {
    	year: 2016,    //阳历的年份
    	month: "01",   //阳历的月份
    	day: 31,       //阳历的天
    	hour: "00",    //小时
    	min: "00",     //分钟
    	lYear: 2015,   //农历的年份
    	lMonth: 12,    //农历的月份
    	lDay: 22,      //农历的天
    	week: 0,       //周几,0表示周日,1表示周一。。。
    	isLeap: false, //是否为闰年
    	isToday: false,//是否为当天 
    	distanceToday : 1,    //表示,明天,2表示后天,表示与今天隔得天数
    	lunarFestival : '',   //农历节日
        solarFestival : '',   //公历节日
        estDayFestival : '',  //右侧显示的复活节
        weekFestival : '',    //周相关的节日
        dateFestival : '',    //公历节日的不同的说法
        lliFestival : '',     //农历节日的不同说法
        solarTerms : ''       //节气
    }
    					
    				

    上述的有些属性,例如节日相关的属性,有可能是不存在的,所以,如果使用节日相关的属性时,请先行做一些判断。

  5. 使用方法–获取指定日期的当天数据

    查看示例:

    					
    var options = {
    	date:"2016/02/02",
    	length : 1
    };
    
    //调用方法
    var arr = xmsCore.xmsCustomDate(options)
    console.log(arr);
    					
    				

    示例:获取指定天的数据对象DEMO

    如果需要更多天数的数据,那么请直接更改length的值,即可。

  6. 使用方法–获取某月的所有日期

    该方法,是用于在日历控件,等需要按月获取日期的场景下使用,返回一个数组,包含一个整月的数据,并且包含了上一个月末的几天,和下一个月初的几天,使数组,是7的倍数。

    					
    var options = {
    	date:"2016/02/02",
    	lineFirst : 0
    };
    //lineFirst为0,表示每周以周日开始
    
    //调用方法
    var arr = xmsCore.xmsCustomDate(options)
    console.log(arr);
    					
    				

    示例:获取指定天的数据对象DEMO

总结

前一篇中XMSDatePicker的基础方法,在XMSDatePicker中,切换月份,计算节日,周几,每周的开始日期等,都是该方法计算出来的,所以我自己认为,该方法是一个很重要的方法,考虑了一下,还是把这个方法,专门出了这篇文章。

如有疑问,请指正!

本文地址:http://www.zhangyunling.com/?p=501

发表评论

电子邮件地址不会被公开。 必填项已用*标注

您可以使用这些HTML标签和属性: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>