# Time 时间格式化

# 按需引入

如果未做全局扩展配置 (opens new window),可以按需引入:

// 引入
import { timeFormat } from '@/uni_modules/uv-ui-tools/libs/function/index.js';
// 调用
timeFormat(...);

# timeFormat(time,format) | date(time,format) 格式化时间

该函数必须传入第一个参数,第二个参数是可选的,函数返回一个格式化好的时间。

  • time <String> 任何合法的 时间格式毫秒 的时间戳
  • format <String> 时间格式,可选。默认为yyyy-mm-dd,年为"yyyy",月为"mm",日为"dd",时为"hh",分为"MM",秒为"ss",格式可以自由搭配,如: yyyy:mm:ddyyyy-mm-ddyyyy年mm月dd日yyyy年mm月dd日 hh时MM分ss秒yyyy/mm/dd/MM:ss等组合
<template>
	<view>
		<view>时间1为:{{time}}</view>
		<view>时间2为:{{time2}}</view>
		<view>时间3为:{{time3}}</view>
		<view>时间4为:{{time4}}</view>
	</view>
</template>
<script>
	export default {
		computed: {
			time(){
				return uni.$uv.timeFormat(new Date().getTime())
			},
			time2(){
				return uni.$uv.timeFormat('2023-08-06','yyyy年mm月dd日 hh时MM分ss秒')
			},
			time3(){
				return uni.$uv.date(new Date().getTime(),'yyyy/mm/dd')
			},
			time4(){
				return uni.$uv.date('2023-08-06','yyyy年mm月dd日')
			}
		}
	}
</script>

# timeFrom(time, format = String | false) 多久以前

该函数必须传入第一个参数,格式为任何合法的时间格式毫秒的时间戳,第二个参数是可选的,返回的值类似刚刚25分钟前3小时前7天前的结果。

如果第二个参数是时间的格式,当前和传入时间戳相差大于一个月时,返回格式化好的时间;如果第二个参数为false,则不会返回格式化好的时间,而是诸如"xxx年前"的结果。

  • timestamp <String> 时间戳
  • format <String / false> 时间格式,默认为yyyy-mm-dd,年为"yyyy",月为"mm",日为"dd",时为"hh",分为"MM",秒为"ss",格式可以自由搭配,如: yyyy:mm:ddyyyy-mm-ddyyyy年mm月dd日yyyy年mm月dd日 hh时MM分ss秒yyyy/mm/dd/MM:ss等组合。 如果时间戳距离此时的时间,大于一个月,则返回一个格式化好的时间,如果此参数为false,返回均为"多久之前"的结果。
<template>
	<view>
		<view>时间1为:{{time1}}</view>
		<view>时间2为:{{time2}}</view>
		<view>时间3为:{{time3}}</view>
	</view>
</template>
<script>
	export default {
		computed: {
			// 刚刚
			time1(){
				return uni.$uv.timeFrom(new Date().getTime())
			},
			// 6个月前
			time2(){
				return uni.$uv.timeFrom(new Date('2023-02-06').getTime(),false)
			},
			// 2023年02月06日
			time3(){
				return uni.$uv.timeFrom(new Date('2023-02-06').getTime(),'yyyy年mm月dd日')
			}
		}
	}
</script>