%\iffalse
%<*package>
%% \CharacterTable
%%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
%%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
%%   Digits        \0\1\2\3\4\5\6\7\8\9
%%   Exclamation   \!     Double quote  \"     Hash (number) \#
%%   Dollar        \$     Percent       \%     Ampersand     \&
%%   Acute accent  \'     Left paren    \(     Right paren   \)
%%   Asterisk      \*     Plus          \+     Comma         \,
%%   Minus         \-     Point         \.     Solidus       \/
%%   Colon         \:     Semicolon     \;     Less than     \<
%%   Equals        \=     Greater than  \>     Question mark \?
%%   Commercial at \@     Left bracket  \[     Backslash     \\
%%   Right bracket \]     Circumflex    \^     Underscore    \_
%%   Grave accent  \`     Left brace    \{     Vertical bar  \|
%%   Right brace   \}     Tilde         \~}
%</package>
%\fi
% \iffalse
% Doc-Source file to use with LaTeX2e
% Copyright (C) 2015-2018 Nicola Talbot, all rights reserved.
% (New maintainer add relevant lines here.)
% \fi
% \iffalse
%<*driver>
\documentclass{ltxdoc}

\usepackage{alltt}
\usepackage{graphicx}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[colorlinks,
            bookmarks,
            hyperindex=false,
            pdfauthor={Nicola L.C. Talbot},
            pdftitle={datetime2.sty Portuguese Module}]{hyperref}


\CheckSum{267}

\renewcommand*{\usage}[1]{\hyperpage{#1}}
\renewcommand*{\main}[1]{\hyperpage{#1}}
\IndexPrologue{\section*{\indexname}\markboth{\indexname}{\indexname}}
\setcounter{IndexColumns}{2}

\newcommand*{\sty}[1]{\textsf{#1}}
\newcommand*{\opt}[1]{\texttt{#1}\index{#1=\texttt{#1}|main}}

\RecordChanges
\PageIndex
\CodelineNumbered

\begin{document}
\DocInput{datetime2-portuges.dtx}
\end{document}
%</driver>
%\fi
%
%\MakeShortVerb{"}
%
%\title{Portuguese Module for datetime2 Package}
%\author{Nicola L. C. Talbot (inactive)}
%\date{2018-08-21 (v1.1)}
%\maketitle
%
%This module is currently unmaintained and may be subject to change.
%If you want to volunteer to take over maintenance, contact me at
%\url{http://www.dickimaw-books.com/contact.html}
%
%\begin{abstract}
%This is the Portuguese language module for the \sty{datetime2}
%package. If you want to use the settings in this module you must
%install it in addition to installing \sty{datetime2}. If you use
%\sty{babel} or \sty{polyglossia}, you will need this module to
%prevent them from redefining \cs{today}. The \sty{datetime2}
% \opt{useregional} setting must be set to "text" or "numeric"
% for the language styles to be set.
% Alternatively, you can set the style in the document using
% \cs{DTMsetstyle}, but this may be changed by \cs{date}\meta{language}
% depending on the value of the \opt{useregional} setting.
%\end{abstract}
%
%I've copied the date style from \texttt{babel-portuges}'s \cs{today}.
%
%I don't know if these settings are correct.
%In particular, I don't know if the "portuges" time style is
%correct. Currently this just uses the "default" time style. Please
%be aware that this may change. Whoever takes over maintanance
%of this module may can change it as appropriate.
%
%The new maintainer should add the line:
%\begin{verbatim}
% The Current Maintainer of this work is Name.
%\end{verbatim}
%to the preamble part in \texttt{datetime2-portuges.ins} where Name
%is the name of the maintainer(s) and replace
%the `inactive' status to `maintained'.
%
%Currently there is only a regionless style. New maintainers may
%want to add regional variants such as "pt-PT"\slash"pt-PT-numeric",
%"pt-BR"\slash"pt-BR-numeric" etc. This style currently doesn't check the
%\opt{showdow} setting.
%
%\StopEventually{%
%\clearpage
%\phantomsection
%\addcontentsline{toc}{section}{Change History}%
%\PrintChanges
%\addcontentsline{toc}{section}{\indexname}%
%\PrintIndex}
%\section{The Code}
%\iffalse
%    \begin{macrocode}
%<*datetime2-portuges-utf8.ldf>
%    \end{macrocode}
%\fi
%\subsection{UTF-8}
%This file contains the settings that use UTF-8 characters. This
%file is loaded if XeLaTeX or LuaLaTeX are used. Please make sure
%your text editor is set to UTF-8 if you want to view this code.
%\changes{1.0}{2015-03-28}{Initial release}
% Identify module
%    \begin{macrocode}
\ProvidesDateTimeModule{portuges-utf8}[2018/08/21 v1.1]
%    \end{macrocode}
%\begin{macro}{\DTMportugesordinal}
%    \begin{macrocode}
\newcommand*{\DTMportugesordinal}[1]{%
  \number#1
}
%    \end{macrocode}
%\end{macro}
%
%\begin{macro}{\DTMportugesmonthname}
% Portuguese month names.
%    \begin{macrocode}
\newcommand*{\DTMportugesmonthname}[1]{%
  \ifcase#1
  \or
  Janeiro%
  \or
  Fevereiro%
  \or
  Março%
  \or
  Abril%
  \or
  Maio%
  \or
  Junho%
  \or
  Julho%
  \or
  Agosto%
  \or
  Setembro%
  \or
  Outubro%
  \or
  Novembro%
  \or
  Dezembro%
  \fi
}
%    \end{macrocode}
%\end{macro}
%
%If abbreviated dates are supported, short month names should be
%likewise provided.
%
%\begin{macro}{\DTMportugesweekdayname}
%These are provided here but not currently used in the date format.
%    \begin{macrocode}
\newcommand*{\DTMportugesweekdayname}[1]{%
  \ifcase#1
  domingo%
  \or
  segunda-feira%
  \or
  terça-feira%
  \or
  quarta-feira%
  \or
  quinta-feira%
  \or
  sexta-feira%
  \or
  sabado%
  \fi
}
%    \end{macrocode}
%\end{macro}
%
%\begin{macro}{\DTMportugesWeekdayname}
%As above but start with a capital.
%    \begin{macrocode}
\newcommand*{\DTMportugesWeekdayname}[1]{%
  \ifcase#1
  Domingo%
  \or
  Segunda-feira%
  \or
  Terça-feira%
  \or
  Quarta-feira%
  \or
  Quinta-feira%
  \or
  Sexta-feira%
  \or
  Sabado%
  \fi
}
%    \end{macrocode}
%\end{macro}
%
%\iffalse
%    \begin{macrocode}
%</datetime2-portuges-utf8.ldf>
%    \end{macrocode}
%\fi
%\iffalse
%    \begin{macrocode}
%<*datetime2-portuges-ascii.ldf>
%    \end{macrocode}
%\fi
%\subsection{ASCII}
%This file contains the settings that use \LaTeX\ commands for
%non-ASCII characters. This should be input if neither XeLaTeX nor
%LuaLaTeX are used. Even if the user has loaded \sty{inputenc} with
%"utf8", this file should still be used not the
%\texttt{datetime2-portuges-utf8.ldf} file as the non-ASCII
%characters are made active in that situation and would need
%protecting against expansion.
%\changes{1.0}{2015-03-28}{Initial release}
% Identify module
%    \begin{macrocode}
\ProvidesDateTimeModule{portuges-ascii}[2018/08/21 v1.1]
%    \end{macrocode}
%
%If abbreviated dates are supported, short month names should be
%likewise provided.
%\begin{macro}{\DTMportugesordinal}
%    \begin{macrocode}
\newcommand*{\DTMportugesordinal}[1]{%
  \number#1
}
%    \end{macrocode}
%\end{macro}
%
%\begin{macro}{\DTMportugesmonthname}
% Portuguese month names.
%    \begin{macrocode}
\newcommand*{\DTMportugesmonthname}[1]{%
  \ifcase#1
  \or
  Janeiro%
  \or
  Fevereiro%
  \or
  Mar\protect\c{c}o%
  \or
  Abril%
  \or
  Maio%
  \or
  Junho%
  \or
  Julho%
  \or
  Agosto%
  \or
  Setembro%
  \or
  Outubro%
  \or
  Novembro%
  \or
  Dezembro%
  \fi
}
%    \end{macrocode}
%\end{macro}
%
%\begin{macro}{\DTMportugesweekdayname}
%These are provided here but not currently used in the date format.
%    \begin{macrocode}
\newcommand*{\DTMportugesweekdayname}[1]{%
  \ifcase#1
  domingo%
  \or
  segunda-feira%
  \or
  ter\protect\c{c}a-feira%
  \or
  quarta-feira%
  \or
  quinta-feira%
  \or
  sexta-feira%
  \or
  sabado%
  \fi
}
%    \end{macrocode}
%\end{macro}
%
%\begin{macro}{\DTMportugesWeekdayname}
%As above but start with a capital.
%    \begin{macrocode}
\newcommand*{\DTMportugesWeekdayname}[1]{%
  \ifcase#1
  Domingo%
  \or
  Segunda-feira%
  \or
  Ter\protect\c{c}a-feira%
  \or
  Quarta-feira%
  \or
  Quinta-feira%
  \or
  Sexta-feira%
  \or
  Sabado%
  \fi
}
%    \end{macrocode}
%\end{macro}
%
%
%\iffalse
%    \begin{macrocode}
%</datetime2-portuges-ascii.ldf>
%    \end{macrocode}
%\fi
%
%\subsection{Main Portuguese Module (\texttt{datetime2-portuges.ldf})}
%\changes{1.0}{2015-03-28}{Initial release}
%
%\iffalse
%    \begin{macrocode}
%<*datetime2-portuges.ldf>
%    \end{macrocode}
%\fi
%
% Identify Module
%    \begin{macrocode}
\ProvidesDateTimeModule{portuges}[2018/08/21 v1.1]
%    \end{macrocode}
% Need to find out if XeTeX or LuaTeX are being used.
%    \begin{macrocode}
\RequirePackage{ifxetex,ifluatex}
%    \end{macrocode}
% XeTeX and LuaTeX natively support UTF-8, so load
% \texttt{portuges-utf8} if either of those engines are used
% otherwise load \texttt{portuges-ascii}.
%    \begin{macrocode}
\ifxetex
 \RequireDateTimeModule{portuges-utf8}
\else
 \ifluatex
   \RequireDateTimeModule{portuges-utf8}
 \else
   \RequireDateTimeModule{portuges-ascii}
 \fi
\fi
%    \end{macrocode}
%
% Define the \texttt{portuges} style.
% The time style is the same as the "default" style
% provided by \sty{datetime2}. This may need correcting. 
%
% Allow the user a way of configuring the "portuges" and
% "portuges-numeric" styles. This doesn't use the package wide
% separators such as
% \cs{dtm@datetimesep} in case other date formats are also required.
%\begin{macro}{\DTMportugesdaymonthsep}
% The separator between the day and month for the text format.
%    \begin{macrocode}
\newcommand*{\DTMportugesdaymonthsep}{\space de\space}
%    \end{macrocode}
%\end{macro}
%
%\begin{macro}{\DTMportugesmonthyearsep}
% The separator between the month and year for the text format.
%    \begin{macrocode}
\newcommand*{\DTMportugesmonthyearsep}{\space de\space}
%    \end{macrocode}
%\end{macro}
%
%\begin{macro}{\DTMportugesdatetimesep}
% The separator between the date and time blocks in the full format
% (either text or numeric).
%    \begin{macrocode}
\newcommand*{\DTMportugesdatetimesep}{\space}
%    \end{macrocode}
%\end{macro}
%
%\begin{macro}{\DTMportugestimezonesep}
% The separator between the time and zone blocks in the full format
% (either text or numeric).
%    \begin{macrocode}
\newcommand*{\DTMportugestimezonesep}{\space}
%    \end{macrocode}
%\end{macro}
%
%\begin{macro}{\DTMportugesdatesep}
% The separator for the numeric date format.
%    \begin{macrocode}
\newcommand*{\DTMportugesdatesep}{/}
%    \end{macrocode}
%\end{macro}
%
%\begin{macro}{\DTMportugestimesep}
% The separator for the numeric time format.
%    \begin{macrocode}
\newcommand*{\DTMportugestimesep}{:}
%    \end{macrocode}
%\end{macro}
%
%Provide keys that can be used in \cs{DTMlangsetup} to set these
%separators.
%    \begin{macrocode}
\DTMdefkey{portuges}{daymonthsep}{\renewcommand*{\DTMportugesdaymonthsep}{#1}}
\DTMdefkey{portuges}{monthyearsep}{\renewcommand*{\DTMportugesmonthyearsep}{#1}}
\DTMdefkey{portuges}{datetimesep}{\renewcommand*{\DTMportugesdatetimesep}{#1}}
\DTMdefkey{portuges}{timezonesep}{\renewcommand*{\DTMportugestimezonesep}{#1}}
\DTMdefkey{portuges}{datesep}{\renewcommand*{\DTMportugesdatesep}{#1}}
\DTMdefkey{portuges}{timesep}{\renewcommand*{\DTMportugestimesep}{#1}}
%    \end{macrocode}
%
% TODO: provide a boolean key to switch between full and abbreviated
% formats if appropriate. (I don't know how the date should be
% abbreviated.)
%
% Define a boolean key that determines if the time zone mappings
% should be used.
%    \begin{macrocode}
\DTMdefboolkey{portuges}{mapzone}[true]{}
%    \end{macrocode}
% The default is to use mappings.
%    \begin{macrocode}
\DTMsetbool{portuges}{mapzone}{true}
%    \end{macrocode}
%
% Define a boolean key that determines if the day of month should be
% displayed.
%    \begin{macrocode}
\DTMdefboolkey{portuges}{showdayofmonth}[true]{}
%    \end{macrocode}
% The default is to show the day of month.
%    \begin{macrocode}
\DTMsetbool{portuges}{showdayofmonth}{true}
%    \end{macrocode}
%
% Define a boolean key that determines if the year should be
% displayed.
%    \begin{macrocode}
\DTMdefboolkey{portuges}{showyear}[true]{}
%    \end{macrocode}
% The default is to show the year.
%    \begin{macrocode}
\DTMsetbool{portuges}{showyear}{true}
%    \end{macrocode}
%
% Define the "portuges" style. (TODO: implement day of week?)
%    \begin{macrocode}
\DTMnewstyle
 {portuges}% label
 {% date style
   \renewcommand*\DTMdisplaydate[4]{%
     \DTMifbool{portuges}{showdayofmonth}
     {\DTMportugesordinal{##3}\DTMportugesdaymonthsep}%
     {}%
     \DTMportugesmonthname{##2}%
     \DTMifbool{portuges}{showyear}%
     {%
       \DTMportugesmonthyearsep
       \number##1 % space intended
     }%
     {}%
   }%
   \renewcommand*\DTMDisplaydate[4]{%
     \DTMifbool{portuges}{showdayofmonth}
     {%
        \DTMportugesordinal{##3}\DTMportugesdaymonthsep
        \DTMportugesmonthname{##2}%
     }%
     {\DTMportugesmonthname{##2}}%
     \DTMifbool{portuges}{showyear}%
     {%
       \DTMportugesmonthyearsep
       \number##1 % space intended
     }%
     {}%
   }%
 }%
 {% time style (use default)
   \DTMsettimestyle{default}%
 }%
 {% zone style
   \DTMresetzones
   \DTMportugeszonemaps
   \renewcommand*{\DTMdisplayzone}[2]{%
     \DTMifbool{portuges}{mapzone}%
     {\DTMusezonemapordefault{##1}{##2}}%
     {%
       \ifnum##1<0 \else+\fi\DTMtwodigits{##1}%
       \ifDTMshowzoneminutes\DTMportugestimesep\DTMtwodigits{##2}\fi
     }%
   }%
 }%
 {% full style
   \renewcommand*{\DTMdisplay}[9]{%
    \ifDTMshowdate
     \DTMdisplaydate{##1}{##2}{##3}{##4}%
     \DTMportugesdatetimesep
    \fi
    \DTMdisplaytime{##5}{##6}{##7}%
    \ifDTMshowzone
     \DTMportugestimezonesep
     \DTMdisplayzone{##8}{##9}%
    \fi
   }%
   \renewcommand*{\DTMDisplay}[9]{%
    \ifDTMshowdate
     \DTMDisplaydate{##1}{##2}{##3}{##4}%
     \DTMportugesdatetimesep
    \fi
    \DTMdisplaytime{##5}{##6}{##7}%
    \ifDTMshowzone
     \DTMportugestimezonesep
     \DTMdisplayzone{##8}{##9}%
    \fi
   }%
 }%
%    \end{macrocode}
%
% Define numeric style.
%    \begin{macrocode}
\DTMnewstyle
 {portuges-numeric}% label
 {% date style
    \renewcommand*\DTMdisplaydate[4]{%
      \DTMifbool{portuges}{showdayofmonth}%
      {%
        \number##3 % space intended
        \DTMportugesdatesep
      }%
      {}%
      \number##2 % space intended
      \DTMifbool{portuges}{showyear}%
      {%
        \DTMportugesdatesep
        \number##1 % space intended
      }%
      {}%
    }%
    \renewcommand*{\DTMDisplaydate}[4]{\DTMdisplaydate{##1}{##2}{##3}{##4}}%
 }%
 {% time style
    \renewcommand*\DTMdisplaytime[3]{%
      \number##1 % space intended
      \DTMportugestimesep\DTMtwodigits{##2}%
      \ifDTMshowseconds\DTMportugestimesep\DTMtwodigits{##3}\fi
    }%
 }%
 {% zone style
   \DTMresetzones
   \DTMportugeszonemaps
   \renewcommand*{\DTMdisplayzone}[2]{%
     \DTMifbool{portuges}{mapzone}%
     {\DTMusezonemapordefault{##1}{##2}}%
     {%
       \ifnum##1<0 \else+\fi\DTMtwodigits{##1}%
       \ifDTMshowzoneminutes\DTMportugestimesep\DTMtwodigits{##2}\fi
     }%
   }%
 }%
 {% full style
   \renewcommand*{\DTMdisplay}[9]{%
    \ifDTMshowdate
     \DTMdisplaydate{##1}{##2}{##3}{##4}%
     \DTMportugesdatetimesep
    \fi
    \DTMdisplaytime{##5}{##6}{##7}%
    \ifDTMshowzone
     \DTMportugestimezonesep
     \DTMdisplayzone{##8}{##9}%
    \fi
   }%
   \renewcommand*{\DTMDisplay}{\DTMdisplay}%
 }
%    \end{macrocode}
%
%\begin{macro}{\DTMportugeszonemaps}
% The time zone mappings are set through this command, which can be
% redefined if extra mappings are required or mappings need to be
% removed.
%    \begin{macrocode}
\newcommand*{\DTMportugeszonemaps}{%
  \DTMdefzonemap{01}{00}{CET}%
  \DTMdefzonemap{02}{00}{CEST}%
}
%    \end{macrocode}
%\end{macro}

% Switch style according to the \opt{useregional} setting.
%    \begin{macrocode}
\DTMifcaseregional
{}% do nothing
{\DTMsetstyle{portuges}}
{\DTMsetstyle{portuges-numeric}}
%    \end{macrocode}
%
% Redefine \cs{dateportuges} (or \cs{date}\meta{dialect}) to prevent
% \sty{babel} from resetting \cs{today}. (For this to work,
% \sty{babel} must already have been loaded if it's required.)
%\changes{1.1}{2018-08-21}{removed spurious space}
%    \begin{macrocode}
\ifcsundef{date\CurrentTrackedDialect}
{%
  \ifundef\dateportuges
  {% do nothing
  }%
  {%
    \def\dateportuges{%
      \DTMifcaseregional
      {}% do nothing
      {\DTMsetstyle{portuges}}%
      {\DTMsetstyle{portuges-numeric}}%
    }%
  }%
}%
{%
  \csdef{date\CurrentTrackedDialect}{%
    \DTMifcaseregional
    {}% do nothing
    {\DTMsetstyle{portuges}}%
    {\DTMsetstyle{portuges-numeric}}%
  }%
}%
%    \end{macrocode}
%\iffalse
%    \begin{macrocode}
%</datetime2-portuges.ldf>
%    \end{macrocode}
%\fi
%\Finale
\endinput
