纷享销客开发者手册

简体中文

English

Date类型

约 700 字大约 2 分钟

2026-01-09

Date - 日期类型，格式为YYYY-MM-DD，使用时用""封装

摘要

本文档的概要说明如下： Date - 日期类型，格式为YYYY-MM-DD，使用时用""封装

定义Date：Date date = "<YYYY-MM-DD>"

例：

Date date = "2019-01-01"

Date类型的方法：

Date.now()：获取当前时间的年月日 例：

Date d = Date.now()

date.withYear(<Integer year>)：设置日期的年，返回新的日期 返回值类型：Date

例：

date.withYear(2018) //返回：2018-01-01

date.withMonth(<Integer month>)：设置日期的月，返回新的日期 返回值类型：Date

例：

date.withMonth(12) //返回：2019-12-01

date.withDay(<Integer day>)：设置日期的日，返回新的日期 返回值类型：Date

例：

date.withDay(30) //返回：2019-01-30

date.toTimestamp()：日期转时间戳 返回值类型：Long

例：

date.toTimestamp() //返回：1567958400000

date.year：获取日期中的年 例：

date.year //返回：2019

date.month：获取日期中的月 例：

date.month //返回：1

date.day：获取日期中的日 例：

date.day //返回：1

date.dayOfWeek：当前日期是周几 例：

date.dayOfWeek //返回：1(周一)

date.weekOfYear：当前日期是本年第几周 例：

date.weekOfYear //返回：1(本年第一周)

date.weekOfMonth：当前日期是本月第几周 例：

date.weekOfMonth //返回：1(本月第一周)

date.dayOfYear：当前日期是本年第几天 例：

date.dayOfYear //返回：1(本年第一天)

date.daysBetween(<Date date>)：返回两个日期间隔的天数 例：

Date date1 = "2020-01-02"

Date date2 = "2020-01-03"

date1.daysBetween(date2) //返回：2

date.monthsBetween(<Date date>)：返回两个日期间隔的月数 例：

Date date1 = "2020-01-01"

Date date2 = "2020-03-03"

date1.monthsBetween(date2) //返回：2
  • date.toStartOfMonth()：返回本月开始日期 例：
Date date = "2020-01-20"

Date dateRetrun = date.toStartOfMonth() //返回：2020-01-01
  • date.toStartOfWeek()：返回本周开始日期 例：
Date date = "2020-01-01"

Date dateRetrun = date.toStartOfWeek() //返回：2020-12-30
  • Date.of(Long timestamp)：时间戳转date 例：
Long timestamp = 1618972431890

Date d =  Date.of(timestamp)
  • Date.of(<String a>)：字符串转date 例：
String a = "2020-01-01"
Date date = Date.of(a)
log.info("date:"+date)

版本记录

版本日期变更内容负责人
v1.02026-05-19初始版本

背景说明

本文档详细描述 Date类型 的相关接口功能和使用方法，帮助开发者快速集成相关能力。

适用场景

具体适用场景由实际业务需求决定，开发者可根据需要选择相应的接口进行集成。

前置条件

  • 已接入纷享销客开放平台
  • 已完成应用授权与配置
  • 了解相关业务领域基础知识

操作步骤

具体操作步骤请参考各接口的详细说明。

注意事项

  • 调用接口前请确保满足前置条件
  • 注意接口调用频率限制
  • 异常情况请参考错误码说明进行处理

兼容性说明：当前版本暂无可用的废弃或兼容性说明。