Luxon SDK – DateMapper

Este pacote fornece utilitários para conversão e manipulação de datas com base no fuso horário de Brasília (America/Sao_Paulo) utilizando a biblioteca Luxon, que já está embutida como dependência.

📦 Instalação

Você só precisa instalar o SDK — a biblioteca luxon será instalada automaticamente:

npm install luxon-sdk-tech-cpx

📘 Objetivo

A classe DateMapper abstrai a manipulação de datas no fuso horário de Brasília com três funções principais:

• Converter qualquer data para horário de Brasília
• Obter a data/hora atual em Brasília
• Converter uma data de Brasília para UTC

Ideal para aplicações que operam com usuários brasileiros ou precisam centralizar a lógica de datas em um único fuso horário padrão.

🧱 API

class DateMapper {
  static toBrasilia(date: Date | string): Date;
  static nowBrasilia(): Date;
  static toUTC(date: Date | string): Date;
}

🔧 Métodos

📌 toBrasilia(date: Date | string): Date

• Converte uma data em qualquer fuso para o horário de Brasília.
• Exemplo:

import { DateMapper } from 'luxon-sdk-tech-cpx';

const dataOriginal = new Date('2025-07-02T12:00:00Z');
const emBrasilia = DateMapper.toBrasilia(dataOriginal);

console.log(emBrasilia); // => Horário em GMT-3

🕒 nowBrasilia(): Date

• Retorna a data/hora atual no fuso horário de Brasília.
• Exemplo:

const agora = DateMapper.nowBrasilia();
console.log(agora); // => Data/hora atual em Brasília

🌐 toUTC(date: Date | string): Date

• Converte uma data no fuso de Brasília para UTC.
• Exemplo:

const dataBrasilia = new Date('2025-07-02T10:00:00-03:00');
const emUtc = DateMapper.toUTC(dataBrasilia);

console.log(emUtc); // => Data convertida para UTC

✅ Requisitos

• Node.js >= 16
• TypeScript >= 4.8 (se estiver usando TypeScript)

📄 Licença

• MIT

👨‍💻 Autor

• Akiyuki Miyama
• [email protected]