toDate(date : string) : Date
将字符串格式的日期转换为JavaScript Date对象
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
date
:string
- 要转换的日期字符串。
返回值
Date
: 如果字符串是有效的日期格式,则返回一个Date
对象,否则可能返回null
或抛出错误。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const date=tuidate.toDate('2025年8月15日')
now() : string
获取当前日期
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
- 无参数。
返回值
string
: 当前日期和时间的字符串,格式为yyyy-MM-dd HH:mm:ss
。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const currentDate = tuidate.now()
console.log(currentDate) // 输出当前日期时间,例如 "2024-11-20 08:30:45"
timestamp():number
获取当前时间时间戳
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
- 无参数。
返回值
number
: 当前日期和时间的Unix时间戳(单位:毫秒)。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const currentTimeStamp = tuidate.timestamp()
console.log(currentTimeStamp) // 输出当前时间的时间戳,例如 1679096400000
nowYear():number
获取今年的年份
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
- 无参数。
返回值
number
: 当前年份的数字表示。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const currentYear = tuidate.nowYear()
console.log(currentYear) // 输出当前年份,例如 2024
lastYear():number
获取去年的年份
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
- 无参数。
返回值
number
: 去年的年份的数字表示。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const lastYear = tuidate.lastYear()
console.log(lastYear) // 输出去年的年份,例如 2023
nextYear():number
获取明年的年份
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
- 无参数。
返回值
number
: 明年的年份的数字表示。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const nextYear = tuidate.nextYear()
console.log(nextYear) // 输出明年的年份,例如 2025
month():number
获取今年的月份
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
- 无参数。
返回值
number
: 当前月份的数字表示(1-12)。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const currentMonth = tuidate.month()
console.log(currentMonth) // 输出当前月份,例如 11
lastMonth():number
获取去年的月份
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
- 无参数。
返回值
number
: 去年同一个月的数字表示(1-12)。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const lastMonth = tuidate.lastMonth()
console.log(lastMonth) // 输出去年同一个月的月份,例如 11
nextMonth():number
获取明年的月份
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
- 无参数。
返回值
number
: 明年同一个月的数字表示(1-12)。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const nextMonth = tuidate.nextMonth()
console.log(nextMonth) // 输出明年同一个月的月份,例如 11
monthDays(year:number,month:number):number
获取指定年月的天数
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
year
: number - 指定的年份。month
: number - 指定的月份(1-12)。
返回值
number
: 指定年月的天数。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const daysInMonth = tuidate.monthDays(2025, 8)
console.log(daysInMonth) // 输出2025年8月的天数,例如 31
monthDates(date:string):string[]
获取指定日期所在月份的所有日期
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | √ | √ | √ |
参数
date
: string - 指定的日期字符串,格式为 'YYYY-MM-DD'。
返回值
string[]
: 包含指定月份所有日期的字符串数组,格式为 'YYYY-MM-DD'。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const allDatesInMonth = tuidate.monthDates('2025-08-15')
console.log(allDatesInMonth) // 输出2025年8月所有日期的数组,例如 ['2025-08-01', '2025-08-02', ..., '2025-08-31']
months(startMonth:string,endMonth:string):string[]
获取两个月份之间的所有月份
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
startMonth
: string - 起始月份,格式为 'yyyy-MM'。endMonth
: string - 结束月份,格式为 'yyyy-MM'。
返回值
- string[]: 两个月份之间的所有月份,格式为 'yyyy-MM'。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const monthsBetween = tuidate.months('2025-01', '2025-06')
console.log(monthsBetween) // 输出从2025年1月到2025年6月之间的所有月份,例如 ["2025-01", "2025-02", "2025-03", "2025-04", "2025-05", "2025-06"]
week():number
获取本周是星期几
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
- 无参数。
返回值
number
: 本周是星期几,其中0代表星期日,1代表星期一,以此类推,6代表星期六。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const currentWeekDay = tuidate.week()
console.log(currentWeekDay) // 输出本周是星期几,例如 3 代表星期三
weeks():string[]
获取本周的所有日期
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
- 无参数。
返回值
- string[]: 包含本周所有日期的数组,格式为 'yyyy-MM-dd'。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const weekDates = tuidate.weeks()
console.log(weekDates) // 输出本周的所有日期,例如 ["2024-11-20", "2024-11-21", ..., "2024-11-26"]
today():string
获取今天的日期
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
- 无参数。
返回值
string
: 当前的日期,格式为 'yyyy-MM-dd'。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const todayDate = tuidate.today()
console.log(todayDate) // 输出今天的日期,例如 "2024-11-20"
yesterday():string
获取昨天的日期
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
- 无参数。
返回值
string
: 昨天的日期,格式为 'yyyy-MM-dd'。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const yesterdayDate = tuidate.yesterday()
console.log(yesterdayDate) // 输出昨天的日期,例如 "2024-11-19"
tomorrow():string
获取明天的日期
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
- 无参数。
返回值
string
: 明天的日期,格式为 'yyyy-MM-dd'。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const tomorrowDate = tuidate.tomorrow()
console.log(tomorrowDate) // 输出明天的日期,例如 "2024-11-21"
dates(startDate:string,endDate:string):string[]
获取两个日期之间的所有日期
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
startDate
: 开始日期,格式为 'yyyy-MM-dd'。endDate
: 结束日期,格式为 'yyyy-MM-dd'。
返回值
- string[]: 包含两个日期之间所有日期的数组,格式为 'yyyy-MM-dd'。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const dateRange = tuidate.dates('2025-08-01', '2025-08-31')
console.log(dateRange) // 输出从2025-08-01到2025-08-31之间的所有日期
time():string
获取当前时间
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
- 无参数。
返回值
string
: 当前的具体时间,格式为 'HH:mm:ss'。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const currentTime = tuidate.time()
console.log(currentTime) // 输出当前时间,例如 "15:45:30"
compare(date1:string,date2:string):number
比较两个日期
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
date1
: 第一个日期字符串,格式为 'yyyy-MM-dd'。date2
: 第二个日期字符串,格式为 'yyyy-MM-dd'。
返回值
number
: 比较结果,如果date1
在date2
之前则返回 -1,如果date1
在date2
之后则返回 1,如果两个日期相同则返回 0。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const comparisonResult = tuidate.compare('2025-08-15', '2025-08-16')
console.log(comparisonResult) // 输出 -1,因为 '2025-08-15' 在 '2025-08-16' 之前
toTimestamp(date:string):number
将日期字符串转换为毫秒时间戳
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
date
: 日期时间字符串,格式为 'yyyy-MM-dd HH:mm:ss'。
返回值
number
: 返回一个表示日期时间的毫秒时间戳。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const timestamp = tuidate.toTimestamp('2025-08-15 12:00:00')
console.log(timestamp) // 输出对应的毫秒时间戳
toMillisecond(time:string):number
将时间字符串转换为毫秒数
支持平台
安卓 | ios | web | 微信小程序 | 支付宝小程序 | QQ小程序 |
---|---|---|---|---|---|
√ | √ | √ | x | x | x |
参数
time
: 时间字符串,格式为 'HH:mm:ss'。
返回值
number
: 返回一个表示时间的毫秒数。
示例
javascript
import { TuiDate } from '@/uni_modules/t-ui'
const tuidate = new TuiDate()
const milliseconds = tuidate.toMillisecond('12:00:00')
console.log(milliseconds) // 输出对应时间的毫秒数