b553c4e519
- API 路由统一: 移除 /api/h5/，统一 /api/pms/ 入口 - 二进制改名: api-server -> pms-api（与服务名一致） - nginx: 合并 /api/ + /pms/api/ 为 /api/pms/ - 新增 docs/API.md 接口文档 - 后端: CabinetDetail 增加 rssi/pow_fail/address/soc 等字段 - Redis 管道批量读取仓体实时数据（SOC/电压/电流/功率） - DB: 所有 TIMESTAMP 列改为 DATETIME（修复类型不匹配） - 用户管理: 新增创建时间/修改时间列，状态改用 Switch - 角色管理/用户管理: 操作按钮改为图标 - PC 设备详情: 基本信息补全 RSSI/ICCID/电源/地址 - PC 卡片: 通道统计改用 Lucide 图标，颜色统一 - PC 二维码: canvas 渲染，含编号文字，支持右键下载 - H5: 按 uni-app 规范修正导航（navigateTo 替代 reLaunch） - H5: 详情页加返回导航条 - H5: 扫码支持摄像头（jsQR）+ ?id= 参数 - H5: 底部 tabBar 在所有页面常显 - H5: 首页统计改为 6 项（设备/通道/空闲/充电/充满/故障） - H5: 下拉刷新 / 上拉加载 - 产品首页: 添加业务联系 - 文档: 清理过时文件，补充缺失规范章节
3.0 KiB
3.0 KiB
category
| category |
|---|
| Time |
useTimeAgoIntl
Reactive time ago with i18n supported. Automatically update the time ago string when the time changes. Powered by Intl.RelativeTimeFormat.
Usage
import { useTimeAgoIntl } from '@vueuse/core'
const timeAgoIntl = useTimeAgoIntl(new Date(2021, 0, 1))
Non-Reactivity Usage
In case you don't need the reactivity, you can use the formatTimeAgo function to get the formatted string instead of a Ref.
import { formatTimeAgoIntl } from '@vueuse/core'
const timeAgoIntl = formatTimeAgoIntl(new Date(2021, 0, 1)) // string
Type Declarations
type Locale = Intl.UnicodeBCP47LocaleIdentifier | Intl.Locale
export interface FormatTimeAgoIntlOptions {
/**
* The locale to format with
*
* @default undefined
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/RelativeTimeFormat/RelativeTimeFormat#locales
*/
locale?: Locale
/**
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/RelativeTimeFormat/RelativeTimeFormat#options
*/
relativeTimeFormatOptions?: Intl.RelativeTimeFormatOptions
/**
* Whether to insert spaces between parts.
*
* Ignored if `joinParts` is provided.
*
* @default true
*/
insertSpace?: boolean
/**
* Custom function to join the parts returned by `Intl.RelativeTimeFormat.formatToParts`.
*
* If provided, it will be used instead of the default join logic.
*/
joinParts?: (
parts: Intl.RelativeTimeFormatPart[],
locale?: Intl.UnicodeBCP47LocaleIdentifier | Intl.Locale,
) => string
/**
* Custom units
*/
units?: TimeAgoUnit[]
}
export interface UseTimeAgoIntlOptions<Controls extends boolean>
extends FormatTimeAgoIntlOptions {
/**
* Expose more controls and the raw `parts` result.
*
* @default false
*/
controls?: Controls
/**
* Update interval in milliseconds, set 0 to disable auto update
*
* @default 30_000
*/
updateInterval?: number
}
type UseTimeAgoReturn<Controls extends boolean = false> = Controls extends true
? {
timeAgoIntl: ComputedRef<string>
parts: ComputedRef<Intl.RelativeTimeFormatPart[]>
} & Pausable
: ComputedRef<string>
export interface TimeAgoUnit {
name: Intl.RelativeTimeFormatUnit
ms: number
}
/**
* A reactive wrapper for `Intl.RelativeTimeFormat`.
*/
export declare function useTimeAgoIntl(
time: MaybeRefOrGetter<Date | number | string>,
options?: UseTimeAgoIntlOptions<false>,
): UseTimeAgoReturn<false>
export declare function useTimeAgoIntl(
time: MaybeRefOrGetter<Date | number | string>,
options: UseTimeAgoIntlOptions<true>,
): UseTimeAgoReturn<true>
/**
* Non-reactive version of useTimeAgoIntl
*/
export declare function formatTimeAgoIntl(
from: Date,
options?: FormatTimeAgoIntlOptions,
now?: Date | number,
): string
/**
* Format parts into a string
*/
export declare function formatTimeAgoIntlParts(
parts: Intl.RelativeTimeFormatPart[],
options?: FormatTimeAgoIntlOptions,
): string