程序包 ohos.miscservices.timeutility

类 Time

java.lang.Object

ohos.miscservices.timeutility.Time

public class Time
extends Object

Defines Time objects used for obtaining and setting the system time and time zone.

This class can be used to obtain the system time, system uptime (including or excluding deep sleep time), thread uptime, and the system time zone.

Obtain the SystemPermission#SET_TIME permission to set system time. Obtain the SystemPermission#SET_TIME_ZONE permission to set the system time zone.

从以下版本开始:

1

SystemCapability

SystemCapability.Miscservices#TIME

构造器概要

构造器

构造器	说明
Time()

方法概要

限定符和类型	方法	说明
static long	getCurrentThreadTime()	Obtains the number of milliseconds elapsed in the current thread.
static long	getCurrentThreadTimeNs()	Obtains the number of nanoseconds elapsed in the current thread.
static long	getCurrentTime()	Obtains the number of milliseconds that have elapsed since the Unix epoch.
static long	getCurrentTimeNs()	Obtains the number of nanoseconds that have elapsed since the Unix epoch.
static long	getRealActiveTime()	Obtains the number of milliseconds elapsed since the system was booted, not including deep sleep time.
static long	getRealActiveTimeNs()	Obtains the number of nanoseconds elapsed since the system was booted, not including deep sleep time.
static long	getRealTime()	Obtains the number of milliseconds elapsed since the system was booted, including deep sleep time.
static long	getRealTimeNs()	Obtains the number of nanoseconds elapsed since the system was booted, including deep sleep time.
static String	getTimeZone()	Obtains the system time zone.
static long	setTime(Context context, long time)	Sets the system time.
static long	setTime(Context context, Date date)	Sets the system time.
static long	setTimeZone(Context context, String timezone)	Sets the system time zone.
static void	sleep(long milliSecond)	Waits a specified number of milliseconds before returning.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

Time

public Time()

方法详细资料

getCurrentTime

public static long getCurrentTime()

Obtains the number of milliseconds that have elapsed since the Unix epoch.

返回:

Returns a positive long integer if obtained; returns a negative number if the time fails to be obtained.

从以下版本开始:

1

getCurrentTimeNs

public static long getCurrentTimeNs()

Obtains the number of nanoseconds that have elapsed since the Unix epoch.

返回:

Returns a positive long integer if obtained; returns a negative number if the time fails to be obtained.

从以下版本开始:

1

getRealActiveTime

public static long getRealActiveTime()

Obtains the number of milliseconds elapsed since the system was booted, not including deep sleep time.

返回:

Returns a positive long integer if obtained; returns a negative number if the time fails to be obtained.

从以下版本开始:

1

getRealActiveTimeNs

public static long getRealActiveTimeNs()

Obtains the number of nanoseconds elapsed since the system was booted, not including deep sleep time.

返回:

Returns a positive long integer if obtained; returns a negative number if the time fails to be obtained.

从以下版本开始:

1

getRealTime

public static long getRealTime()

Obtains the number of milliseconds elapsed since the system was booted, including deep sleep time.

返回:

Returns a positive long integer if obtained; returns a negative number if the time fails to be obtained.

从以下版本开始:

1

getRealTimeNs

public static long getRealTimeNs()

Obtains the number of nanoseconds elapsed since the system was booted, including deep sleep time.

返回:

Returns a positive long integer if obtained; returns a negative number if the time fails to be obtained.

从以下版本开始:

1

getCurrentThreadTime

public static long getCurrentThreadTime()

Obtains the number of milliseconds elapsed in the current thread.

返回:

Returns a positive long integer if obtained; returns a negative number if the time fails to be obtained.

从以下版本开始:

1

getCurrentThreadTimeNs

public static long getCurrentThreadTimeNs()

Obtains the number of nanoseconds elapsed in the current thread.

返回:

Returns a positive long integer if obtained; returns a negative number if the time fails to be obtained.

从以下版本开始:

1

setTime

public static long setTime(Context context,
                           long time)

Sets the system time.

To use this method, obtain the SystemPermission#SET_TIME permission.

参数:

context - Indicates the application context used for permission verification.

time - Indicates a timestamp to set.

返回:

Returns 0 if the time is set; returns a negative number otherwise.

从以下版本开始:

1

setTime

public static long setTime(Context context,
                           Date date)

Sets the system time.

To use this method, obtain the SystemPermission#SET_TIME permission.

参数:

context - Indicates the application context used for permission verification.

date - Indicates a Date object to set.

返回:

Returns 0 if the time is set; returns a negative number otherwise.

从以下版本开始:

1

getTimeZone

public static String getTimeZone()

Obtains the system time zone.

返回:

Returns the time zone, for example, "Asia/Shanghai".

从以下版本开始:

1

setTimeZone

public static long setTimeZone(Context context,
                               String timezone)

Sets the system time zone.

To use this method, obtain the SystemPermission#SET_TIME_ZONE permission.

参数:

context - Indicates the application context used for permission verification.

timezone - Indicates the time zone to set.

返回:

Returns 0 if the time zone is set; returns a negative number otherwise.

从以下版本开始:

1

sleep

public static void sleep(long milliSecond)

Waits a specified number of milliseconds before returning.

参数:

milliSecond - Indicates the number of milliseconds to wait.

从以下版本开始:

1