@voidsolutions/vue-dateformat

A Vue.js component for formatting dates
5,642 2
Install
npm install @voidsolutions/vue-dateformat
Latest Version:0.5.1
Vue:3
Last Updated:Jul 12, 2023
Links: GitHub  ·  npm
Maintainer: wasiqwiqar

Vue DateFormat

This plugin is compatible with Vue 3

Vue-DateFormat is a component designed to format dates in a Vue.js application. It simple takes in a Date or String and converts it via toLocaleString() with different options passed in depending on your props.

For any bugs or feature requests, regarding this component, head on over to the issues page. For any queries that do not relate to this exact component, contact us at Void Solutions.

Installation

npm i @voidsolutions/vue-dateformat

Nuxt 3 Compatiblity

We need to create a plugin to use this component globally in Nuxt 3. Create dateformat.client.js to your /plugins directory. The contents of the file should be as follows:

import dateformat from "@voidsolutions/vue-dateformat";

export default defineNuxtPlugin(nuxtApp => {
    nuxtApp.vueApp.use(dateformat);
})

You can now use the component in your templates as follows:

<date-format :date="new Date()" />

Usage as a global component in Vue 3

In your main.js file, import the component and register it as a global component.

import { createApp } from 'vue'
const app = createApp(App)
...

import DateFormat from '@voidsolutions/vue-dateformat'
app.use(DateFormat);

...

app.mount('#app')

In your template, use the component as follows:


<date-format :date="new Date()" />

Props

Prop Type Default Description
date String or Date new Date() The date to be formatted
no-seconds Boolean false If true, the seconds will not be displayed
no-minutes Boolean false If true, the minutes will not be displayed
no-hours Boolean false If true, the hours will not be displayed
no-days Boolean false If true, the day of the month will not be displayed
no-month Boolean false If true, the month will not be displayed
no-date Boolean false If true, the date will not be displayed
short-month Boolean false If true, the month will be abbreviated
no-year Boolean false If true, the year will not be displayed
has-time Boolean false Whether to show a time component
classes String 'vs-date' Classes to be applied to the <span>
locales String or Array navigator.languages The locale to be used for formatting

Examples

Here are some examples for you to become familiar with our date formatter.

No Props

<date-format :date="1/1/2020" />

Output: 1 January 1970

No days, Short month

<date-format :date="1/1/2020" no-days short-month />

Output:  Jan 2020

Custom Styling

You can also use the classes prop to pass any specific class over to the <span> tag, just on the off chance you need something like that.

Version History

Version Released Vue License
0.5.1 ^3.2.41
0.5.0 ^3.2.41
0.4.0 ^3.2.41
0.3.2 ^3.2.41
0.3.1 ^3.2.41