Módulo:Data/doc
Aspeto
Esta é uma subpágina de documentação para o Módulo:Data. Ela contém informações sobre o seu uso, categorias, bem como todo o conteúdo que não faz parte do módulo original. |
Descrição
[editar código-fonte]Este módulo tem funções auxiliares para criar infocaixas onde se mostra uma ligação para artigos sobre eventos com datas.
Ver módulo de dados Módulo:Data/Dados
Uso
[editar código-fonte]Funções que podem ser usadas de uma predefinição
[editar código-fonte]modeloData (frame)
- exibe uma data com os links mais relevantes (definições abaixo).templateInscriptionDate (frame)
- exibe uma data não relacionada corretamente formatada. O ano é obrigatório. Parâmetros nomeados ano, mês, dia.dateISO (frame)
- semelhante a templateInscriptionDate, mas a data está no formato aaaa-mm-dd. Parâmetros nomeados ano, mês, dia. Para respeitar a ISO 8601, que define a data apenas de acordo com o calendário gregoriano, essa função não retorna nada para datas anteriores a 1583.dateInfobox (frame)
exibe uma data com os links relevantes, manipula corretamente os parâmetros que já contêm um modelo de data ou com o texto após a data (precisions below ). Projetado para ser usado em Infobox.erroModuleData ()
- retorna uma mensagem de erro se o módulo: Data / Data não for carregado corretamente.checkDataCat (frame)
- retorna uma lista anual e mensal de páginas para facilitar atualizações de Data / Data. Parâmetros 1 = cat, month = lista de meses se 'yes', alias = listar todos os aliases se 'yes'
Funções que podem ser usadas de outro módulo
[editar código-fonte]validMonth (month)
- retorna o nome em português e o número domês
(nome em portuguÊs, abreviado, inglês ou número entre 1 e 12).determinationMes (mês, frame)
- semelhante a validMonth, mas o número do mês não é limitado (14 → fevereiro) e pode até ser uma expressão se um objeto de quadro for fornecido (6 + 3 → setembro)do_dayRank (argumentos)
- Rank do dia no ano. Argumentos de parâmetro = {ano, mês, dia} ou {ano = ano, mês = mês, dia = dia}isLeapYear (year)
- retorna true se year for um ano bissexto no calendário gregoriano.toRoman (number)
- transforma o número em uma string representando-o em "algarismos romanos".idade (an, mn, jn, ac, mc, jc)
- semelhante ao modelAge, mas os parâmetros não estão em uma tabela- <Código>julianday (ano, mês, dia, hora, minuto, segundo) - retorna a Julian Day a data passou, de acordo com a calendário astronômico gregoriano ( com o ano 0)
- <Código>julianDayJulian (ano, mês, dia, hora, minuto, segundo) - retorna a Julian dia um datado de Astronomical Julian calendário (com ano 0)
- <Código>julianDayToGregorian (JD) - retorna três variáveis ano, mês, dia representando a data do calendário gregoriano astronômico correspondente ao dia Julian.
julianDayToJulian (jd)
- retorna três variáveis ano, mês, dia representando a data de Julian calendar correspondente a este dia juliano.julianToGregorian (ano, mês, dia)
- transforma uma data do calendário juliano na data do calendário gregoriano.gregorianToJulian (ano, mês, dia)
- transforma uma data do calendário gregoriano para o calendário juliano.
Módulos externos que este módulo precisa para funcionar
[editar código-fonte]Data/Dados
- banco de dados que permite não testar as páginas que sabemos que existem ou não existem.Data complexa
- para adicionar links nas datas que existem ou não existem.TableBuilder
- fr:Module:TableBuilder - Utilizar.insert
e.concat
para simplificar a sintaxe.
modeloData( frame )
[editar código-fonte]Parâmetros
[editar código-fonte]1
- dia ou em branco - numérico, possível exceção para 1º.2
- mês ou dia - nome numérico ou português ou inglês, possivelmente uma abreviação atual.3
- ano ou mês - Um número será considerado ano. Os anos são considerados como seguindo o calendário gregoriano depois de 14 de outubro de 1582 (a menos que Juliano = 'sim') e o calendário juliano antes, sem o ano 0.4
- qualificador ou ano - texto correspondente a uma página típica "em fotografia" para "2008 na fotografia"5
- qualificadorage
ouage
- não está vazio para exibir a idade (nenhuma idade é exibida para datas no futuro)juliano
- 'sim' para a data a ser considerada como seguindo o calendário juliano depois de 14 de outubro de 1582. A data gregoriana com links é exibida, seguida pela data juliana entre parênteses.a.C.
- 'não' para não exibir 'a.C. ' depois do ano se representa um ano antes de Cristo. Útil para evitar repetições.- Página de parâmetros
- Se um template {{data}} contém este parâmetro, os parâmetros
juliano
,a.C.
equalifier < / code> será aplicado a todas as datas na página, a menos que outro valor desses parâmetros seja especificado. O modelo de data que contém esse parâmetro não precisa ser exibido pelo módulo Data e pode ser comentado na página. A página deve ser limpa para que esse parâmetro seja levado em consideração.
qualifier
- o qualificador para aplicar em toda a página. Funciona somente em conjunto com o parâmetropage parameters
Funcionamento
[editar código-fonte]
- o modelo procura exibir a data com links para as páginas dos qualificadores. Se não houver uma página vinculada ao qualificador, um link será feito para a página geral.
- o primeiro parâmetro está vazio e o terceiro é um mês (somente texto), todos os parâmetros são considerados offset e o ano não será exibido.
- Se não houver uma página específica para este mês-ano, o mês será exibido vinculado ao dia das efemérides. A prioridade é dada às efemérides do qualificador no link mês-ano sem qualificador.
- o modelo usa o banco de dados Data/Dados para evitar o uso da função mw.title (equivalente do parser #ifexist :).
- esta base permite substituir o qualificador por uma categoria mais genérica. Se o qualificador estiver "no tênis", as efemérides e a página mensal serão vinculadas ao qualificador "no esporte".
- para evitar repetir o mesmo qualificador em todas as datas da página, basta ter em algum lugar no texto da página, mesmo em comentários, mas não trazido por um modelo, o texto
{{Data|parâmetros page =|qualifier = meu qualificador}}
. O modelo pode conter outros parâmetros. Somente o primeiro modelo de data contendo esse parâmetro será levado em consideração.
Função modeloData
[editar código-fonte]
Motif testado
Cadeia testada
Módulo
Funções custosas
modelo de antes / módulo
data recente
14|outubro|2001
1 / 0
date antiga (1700 - 1943), jour =1
1|outubro|1842
1 / 1
date muito antiga (<1700), dia = 1º
1|janeiro|537
1 / 0
qualificador que não está na base
14|outubro|2010|na animação ásiatica
4 / 1
data antiga, qualificador que não está na base
14|outubro|1842|na animação ásiatica
4 / 2
com qualificativo
14|Outubro|2001|na astronomia
3 / 0
com qualificador com efemérides
14|outubro|2005|nas ferrovias
4 / 0
sem dia
|outubro|2001
1 / 0
sem dia com qualificativo
|Outubro|2001|na astronomia
3 / 0
qualificador com página anual que poderia existir
14|outubro|2006|no Egito
4 / 1
qualificador com página mensal existente
14|outubro|2017|em Portugal
3 / 0
qualificador com página mensal que poderá existir
14|outubro|2012|em Portugal
4 / 1
qualificador com página anual e mensal que poderá existir
14|outubro|2012|na economia
4 / 2
date ancienne avec qualificativo
14|outubro|1845|en aéronautique
4 / 1
data negativa
13|outubro|-63
1 / 0
data a.C.
1|outubro|63 a.C.
1 / 0
data a.C.
13|outubro|63 a.C.
1 / 0
data negativa, parâmetro para esconder a.C.
13|outubro|-63|aC=não
1 / 0
année invalide
14|outubro|2001 en sport
Ano inválido (2001 en sport)
1 / 0
dia + mês com maíscula
14|Outubro|2001
1 / 0
mês abreviado
14|oct.|2001
Mês inválido (oct.)
1 / 0
mês em numeros
14|10|2001
1 / 0
mês inválido
14|outubre|2001
Mês inválido (outubre)
1 / 0
dia inválido
quinta-feira 14|outubro|2001
Dia inválido (quinta-feira 14)
1 / 0
dia inválido (muito grande para o mês)
31|setembro|2001
Dia inválido (31 setembro)
1 / 0
só o ano
||2001
1 / 0
só o ano com qualificador
||2001|na literatura
1 / 0
sem ano
14|outubro
0 / 0
só o dia
14
0 / 0
só o mês
|Outubro
outubro
0 / 0
sem argumento
0 / 0
data do calendário juliano
1|outubro|2001|juliano=sim
1 outubro 2001 ( dentro do calendário gregoriano)
Data do calendário juliano (mudança do mês)
25|outubro|2001|juliano=sim
25 outubro 2001 ( dentro do calendário gregoriano)
Data do calendário juliano (mudança do ano)
25|dezembro|2001|juliano=sim
25 dezembro 2001 ( dentro do calendário gregoriano)
data de nascimento
14|outubro|2001|idade=sim
Comparação com {{ani}}
[editar código-fonte]
- as funções caras são as mesmas que as do modelo Data
- sem idade, veja a comparação com {{Date}}
Motivo testado
Cadeia testada
Predefinição Idade em anos e meses e Ani
Módulo
simples
1|8|2006|idade=sim
2009 de agosto de 1 (2023 anos)
com qualificativo
1|agosto|2006|na Suíça|idade=sim
1 de agosto de 2006 (18 anos)
data antiga
2|1|598|idade=sim
2 de janeiro de 598 (1426 anos)
o ano anterior
2|1|2012|idade=sim
1 de fevereiro de 2012 (12 anos)
este ano
2|1|2013|idade=sim
11 anos e 8 meses
ano que vem
2|1|2014|age=sim
sem dia
|8|2006|idade=sim
agosto de 2009 (15 anos)
ano único
||2006|idade=sim
2006 (17–18 anos)
Comparação com date sport
[editar código-fonte]
- quando não há qualificador, "in sport" é adicionado para testar o módulo.
Motivo testado
Cadeia testada
Predefinição date sport
Módulo
Funções custosas
predefinição / módulo
simples
1|2|1980
1|2|1980}}
1 / 0
com qualificativo
12|2|1980|na ginástica
12|2|1980|na ginástica}}
2 / 0
qualificador com possível página para este ano
12|2|1977|na ginástica
12|2|1977|na ginástica}}
3 / 1
com qualificativo e idade
12|2|1980|na ginástica|age=sim
12|2|1980|na ginástica|age=sim}}
2 / 0
data antiga
12|2|1843
12|2|1843}}
1 / 0
data muito recente com página mensal
12|2|2006
12|2|2006}}
1 / 0
data muito recente sem página mensal e qualif
12|2|2006|na ginástica
12|2|2006|na ginástica}}
2 / 0
data muito recente sem página mensal
1|8|2013
1|8|2013}}
1 / 1
data muito recente sem página mensal
e qualificado com a página anual possível
1|8|2013|na ginástica
1|8|2013|na ginástica
3 / 2
dataInfobox( frame )
[editar código-fonte]
Função destinada a infoboxes, especialmente para exibir as datas de nascimento e morte, os links presentes nas datas fornecidas são automaticamente excluídos para gerenciar casos em que o parâmetro já contenha um modelo de data. O conteúdo do parâmetro após a data (por exemplo, um local, uma referência) é mantido.
Parâmetros
[editar código-fonte]
- 1: tipo de data a exibir (nascimento / n, morte / m ou data / d)
- 2: data ou data de nascimento
- 3: Data da morte, se o tipo n ou m
qualifier
: sufixo das páginas de data para link (exemplo: na música)
nolinks
: não mostra link
- prefixo
: prefixo a ser exibido se houver um dia (padrão vazio)
- prefixo
sem dia
: prefixo a ser exibido se não houver dia (padrão vazio)
Esses parâmetros devem estar diretamente na função de chamada #invoke.
Exemplos
[editar código-fonte]
{{#invoke:Data|dataInfobox|data|13 de julho de 1927}}
→ 13 de julho de 1927
{{#invoke:Data|dataInfobox|nascimento|13 de julho de 1927|}}
→ 13 de julho de 1927
{{#invoke:Data|dataInfobox|nascimento|13 de julho de 1927|14 mai 2017}}
→ 13 de julho de 1927
{{#invoke:Data|dataInfobox|nascimento|30 de junho de 2017-}}
→ 30 de junho de 2017-
{{#invoke:Data|dataInfobox|morte|13 de julho de 1927|30 de junho de 2017}}
→ 30 de junho de 2017
{{#invoke:Data|dataInfobox|morte||30 de junho de 2017}}
→ 30 de junho de 2017
{{#invoke:Data|dataInfobox|morte|13 de julho de 1927|}}
→
{{#invoke:Data|dataInfobox|data|13 de julho de 1927| qualificativo = na França}}
→ 13 de julho de 1927
{{#invoke:Data|dataInfobox|data|13 de julho de 1927| préfixe = le}}
→ 13 de julho de 1927
{{#invoke:Data|dataInfobox|data|13 de julho de 1927| préfixe = le|préfixe sans jour = en}}
→ 13 de julho de 1927
{{#invoke:Data|dataInfobox|data|julho de 1927| préfixe = le}}
→ julho
{{#invoke:Data|dataInfobox|data|julho de 1927| préfixe = le | préfixe sans jour = en}}
→ julho
{{#invoke:Data|dataInfobox|data|13 de julho de [[1927]]}}
→ 13 de julho de 1927
{{#invoke:Data|dataInfobox|data|13 de julho de [[1927 na França|1927]]}}
→ 13 de julho 1927
{{#invoke:Data|dataInfobox|data|{{data|13 de julho de 1927|na França}}}}
→ O primeiro parâmetro é necessário, mas foi fornecido incorretamente! de 13 de julho de 1927
Outra documentação: