format-styles v1.0.3-beta.1

Format Styles

Format Styles es un potente paquete de NPM diseñado para brindar capacidades de formato de tiempo a bots y aplicaciones de Discord. Con este paquete, podrás convertir sin esfuerzo un valor de tiempo en milisegundos en una cadena de tiempo formateada, personalizable según diversas opciones.

Características Principales:

1. Formato de Tiempo Flexible: Convierte valores de milisegundos en representaciones de tiempo fáciles de entender.

2. Opciones Personalizables: Ajusta el formato de salida según tus preferencias. Elige entre una variedad de opciones, como unidades de tiempo (horas, minutos, segundos), estilos de formato (reloj de 12 horas o 24 horas) y más.

3. Integración con Bots de Discord: Integra el paquete Format Styles sin problemas en tus bots o aplicaciones de Discord para contar con una funcionalidad eficiente de formato de tiempo.

Ejemplo de Uso:

const { createFormatDuration } = require("format-styles");
const formatDuration = createFormatDuration();

// Ejemplo: Convertir hasta el segundo con decimal para la unidad más pequeña
console.log(formatDuration(8000)); // Salida: '8 seconds'
console.log(formatDuration(9250)); // Salida: '9.25 seconds'

// Opción: "language" (Idioma)
console.log(formatDuration(3000, { language: "es" })); // Salida: '3 segundos'
console.log(formatDuration(5000, { language: "en" })); // Salida: '5 seconds'

// Opción: "delimiter" (Delimitador)
console.log(formatDuration(22140000, { delimiter: " y " })); // Salida: '6 hours y 9 minutes'
console.log(formatDuration(22140000, { delimiter: "--" })); // Salida: '6 hours--9 minutes'

// Opción: "spacer" (Espaciador)
console.log(formatDuration(260040000, { spacer: " hi " })); // Salida: '3 hi days, 14 hi minutes'
console.log(formatDuration(260040000, { spacer: "" })); // Salida: '3days, 14minutes'

// Opción: "largest" (Máximo de unidades mostradas)
console.log(formatDuration(1000000000000)); // Salida: '31 years, 8 months, 1 week, 19 hours, 46 minutes, 40 seconds'
console.log(formatDuration(1000000000000, { largest: 2 })); // Salida: '31 years, 8 months'

// Opción: "units" (Unidades de tiempo)
console.log(formatDuration(3600000, { units: ["h"] })); // Salida: '1 hour'
console.log(formatDuration(3600000, { units: ["m"] })); // Salida: '60 minutes'
console.log(formatDuration(3600000, { units: ["d", "h"] })); // Salida: '1 hour'

// Opción: "round" (Redondeo)
console.log(formatDuration(1200)); // Salida: '1.2 seconds'
console.log(formatDuration(2300, { round: true })); // Salida: '2 seconds'
console.log(formatDuration(2700, { round: true })); // Salida: '3 seconds'

// Opción: "conjunction" & "serialComma" (Conjunción y coma serial)
console.log(formatDuration(22140000, { conjunction: " y " })); // Salida: '6 hours, y 9 minutes'
console.log(formatDuration(22141000, { conjunction: "y" })); // Salida: '6 hours, 9 minutes,y1 second'
console.log(
  formatDuration(22140000, { conjunction: " and ", serialComma: false })
); // Salida: '6 hours and 9 minutes'
console.log(
  formatDuration(22141000, { conjunction: " and ", serialComma: false })
); // Salida: '6 hours, 9 minutes and 1 second'

// Ejemplo combinando múltiples opciones
console.log(
  formatDuration(22141000, {
    language: "en",
    delimiter: " | ",
    spacer: " - ",
    largest: 3,
    units: ["h", "m", "s"],
    round: true,
    conjunction: " and ",
    serialComma: false,
  })
);
// Salida: '6 - hours | 9 - minutes and 1 - second'

En el último ejemplo, se combinan múltiples opciones para personalizar la visualización de la duración. Se establece el idioma en inglés, el delimitador como "|", el espaciador como "-", se muestra un máximo de 3 unidades de tiempo (largest), se utilizan las unidades de horas, minutos y segundos, se redondea la unidad más pequeña (round), se establece la conjunción como "and" y se desactiva la coma serial (serialComma). La salida será "6 hours | 9 minutes and 1 second".

Espero que estos ejemplos te ayuden a comprender mejor las opciones disponibles en Format Styles. Si tienes más preguntas, ¡no dudes en hacerlas!

Instalación:

Para comenzar a utilizar el paquete Format Styles, instálalo a través de npm:

npm install format-styles

Para obtener más información sobre cómo utilizar el paquete y explorar todas sus funciones, háblame a mi Discord jainagam3r45.