Skip to main content
版本:v2

Time

API_LEVEL 2.0 开始支持,API 兼容性请参考 API_LEVEL

时间/日期传感器。

方法

getTime

获取 UTC 时间戳,单位毫秒

getTime(): number

getFullYear

获取当前日期的年份

getFullYear(): number

getMonth

获取当前日期的月份,范围 1 - 12,返回 1 代表 1 月

getMonth(): number

getDate

获取当前日期的天数,即一个月中的哪一天,范围 1 - 31

getDate(): number

getHours

获取当前时间的小时数

getHours(): number

getMinutes

获取当前时间的分钟数

getMinutes(): number

getSeconds

获取当前时间的秒数

getSeconds(): number

getDay

获取当前时间对应一周中的第几天,范围 1 - 7,返回 1 代表星期一

getDay(): number

getHourFormat

API_LEVEL 2.1

获取当前系统时间格式,12 小时/24 小时,值参考小时格式常量

getHourFormat(): number

常量

小时格式常量
常量说明API_LEVEL
TIME_HOUR_FORMAT_1212 小时制2.1
TIME_HOUR_FORMAT_2424 小时制2.1

getFormatHour

API_LEVEL 2.1

获取当前时间格式(12 小时/24 小时)下的小时数

getFormatHour(): number

onPerMinute

API_LEVEL 2.1

注册每分钟结束事件监听回调函数

onPerMinute(callback: () => void): void

onPerDay

API_LEVEL 2.1

注册每天结束事件监听回调函数

onPerDay(callback: () => void): void

getFestival

获取公历节日,如果没有节日,则返回字符串 'INVALID'

getFestival(): string

getLunarYear

获取中国农历年份,仅在系统语言设置为中文时生效

getLunarYear(): number

getLunarMonth

获取中国农历月份,仅在系统语言设置为中文时生效

getLunarMonth(): number

getLunarDay

获取中国农历日期,仅在系统语言设置为中文时生效

getLunarDay(): number

getLunarFestival

获取中国农历节日,仅在系统语言设置为中文时生效,如果没有节日,则返回字符串 'INVALID'

getLunarFestival(): string

getSolarTerm

获取中国农历节气,仅在系统语言设置为中文时生效,如果没有节气,则返回字符串 'INVALID'

getSolarTerm(): string

getShowFestival

获取当天显示的节日字符串,仅在系统语言设置为中文时生效,优先级依次是公历节日、中国农历节日、中国农历节气,

getShowFestival(): string

getLunarMonthCalendar

获取中国农历当前月的月历信息,仅在系统语言设置为中文时生效

getLunarMonthCalendar(): LunarMonthCalendar

LunarMonthCalendar

属性类型说明API_LEVEL
day_countnumber当前月的天数2.0
lunar_days_arrayArray<string>当前月每一天展示内容数组,展示内容优先级为节日、节气、日期2.0

代码示例

import { Time } from '@zos/sensor'

const time = new Time()
const currentTime = time.getTime()