hijri

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

O pacote hijri fornece conversão sem interrupções entre datas do calendário Hijri (islâmico) e gregoriano em aplicativos Flutter. Ele suporta os idiomas árabe e inglês, tornando-o ideal para aplicações voltadas para comunidades muçulmanas ou que necessitam de cálculos de datas religiosas. O pacote é leve, fácil de integrar e funciona em todas as principais plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux. Ele trata formatação e análise de datas com precisão, garantindo resultados confiáveis para eventos do calendário islâmico como Ramadan e Eid.

Casos de uso

Agendamento de eventos islâmicos
exibição do calendário multilíngue
Desenvolvimento de aplicativo religioso
Conversão de data em aplicativos financeiros
Compatibilidade entre calendários

Principais recursos

Conversão de data Hijri-Gregoriana
Suporte de localidade árabe e inglês
Implementação independente de plataforma
Cálculos precisos do calendário islâmico
Integração simples da API

Indicado para

Aplicativos para usuários muçulmanos
Aplicações religiosas ou culturais
manuseio de data internacional
Aplicativos móveis e web que precisam de calendários duplos
Desenvolvedores que suportam múltiplos idiomas

Considerações

Requer conhecimento das regras do calendário hijri
Limitado à precisão de data
Sem tratamento de fuso horário
Depende de datas de entrada precisas
Pode ser necessário formatação adicional para exibição na interface do usuário

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Hijri Calendar Converter

Usage

//Suppose current gregorian data/time is: Mon May 29 00:27:33  2018
  var _today = HijriCalendar.now();
  print(_today.hYear); // 1439
  print(_today.hMonth); // 9
  print(_today.hDay); // 14
  print(_today.getDayName()); // 14
  // Get month length in days
  print(_today.lengthOfMonth); // 30 days
  print(_today.toFormat("MMMM dd yyyy")); //Ramadan 14 1439

Change Local

  HijriCalendar.setLocal(locale);

Add New Locale

  HijriCalendar.addLocale(locale, {
    'long': ...,
    'short': ...,
    'days': ...,
    'short_days': ...
  });
  HijriCalendar.setLocal(locale);

From Gregorian to Ummalqura

var h_date = HijriCalendar.fromDate(DateTime(2018, 11, 12));
print(h_date.toString()); //04/03/1440H
print(h_date.getShortMonthName()); //Rab1
print(h_date.getLongMonthName()); //Rabi' al-awwal
print(h_date.lengthOfMonth); // 29 days

Check if date is valid

  //
  var _check_date = HijriCalendar();
  _check_date.hYear = 1439;
  _check_date.hMonth = 11;
  _check_date.hDay = 30;
  print(_check_date.isValid()); // false -> This month is only 29 days

From Ummalqura to Gregorian

  //From Ummalqura to Gregorian
  var g_date = HijriCalendar();
  print(g_date.hijriToGregorian(1415, 7, 27)); //1994-12-29 00:00:00.000

Format

  var _format = HijriCalendar.now();
  print(_format.fullDate()); //Thulatha, Ramadan 14, 1439 h
  print(_format.toFormat("mm dd yy")); //09 14 39

Compare

  //Suppose current hijri data is: Thulatha, Ramadan 14, 1439 h
  print(_today.isAfter(1440, 11, 12)); // false
  print(_today.isBefore(1440, 11, 12)); // true
  print(_today.isAtSameMomentAs(1440, 11, 12)); // false

Buscar pacotes, repositórios e categorias de apps

hijri

Instalar pacote