{"title":"django.contrib.humanize","version":"5.1","locale":"ja","docname":"ref/contrib/humanize","url":"/ja/5.1/ref/contrib/humanize/","canonical":"https://djangodocs.dev/ja/5.1/ref/contrib/humanize/","summary":"humanize は、データに「人間くささ（human touch）」を与えるための Django テンプレートフィルタセットです。 これらのフィルタを有効にするには、 INSTALLED_APPS 設定に 'django.contrib.humanize' を加えます。インストール後、テンプレート上で {% load…","html":"<span id=\"django-contrib-humanize\"></span><h1><code class=\"docutils literal notranslate\"><span class=\"pre\">django.contrib.humanize</span></code><a class=\"heading-anchor\" href=\"#module-django.contrib.humanize\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>humanize は、データに「人間くささ（human touch）」を与えるための Django テンプレートフィルタセットです。</p>\n<p>これらのフィルタを有効にするには、 <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-INSTALLED_APPS\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">INSTALLED_APPS</span></code></a>  設定に <code class=\"docutils literal notranslate\"><span class=\"pre\">'django.contrib.humanize'</span></code> を加えます。インストール後、テンプレート上で <code class=\"docutils literal notranslate\"><span class=\"pre\">{%</span> <span class=\"pre\">load</span> <span class=\"pre\">humanize</span> <span class=\"pre\">%}</span></code> を呼び出せば、以下のフィルタを利用できるようになります:</p>\n<section id=\"apnumber\">\n<span id=\"std-templatefilter-apnumber\"></span><h2><code class=\"docutils literal notranslate\"><span class=\"pre\">apnumber</span></code><a class=\"heading-anchor\" href=\"#apnumber\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>1-9 の数字に対して、数をアルファベットで表します。それ以外の数はそのまま数字で返します。これは AP スタイルブックの書式に従っています。</p>\n<p>例:</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">1</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">one</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">2</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">two</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">10</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">10</span></code> になります。</p></li>\n</ul>\n<p>渡す値は整数でも、整数を文字列で表したものでもかまいません。</p>\n</section>\n<section id=\"intcomma\">\n<span id=\"std-templatefilter-intcomma\"></span><h2><code class=\"docutils literal notranslate\"><span class=\"pre\">intcomma</span></code><a class=\"heading-anchor\" href=\"#intcomma\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>整数または浮動小数点数 (またはどちらかの文字列表現) を受け取り、3桁ごとにカンマが入った文字列に変換します。</p>\n<p>例:</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">4500</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">4,500</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">4500.2</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">4,500.2</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">45000</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">45,000</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">450000</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">450,000</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">4500000</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">4,500,000</span></code> になります。</p></li>\n</ul>\n<p>可能であれば <a class=\"reference internal\" href=\"/ja/5.1/topics/i18n/formatting/\"><span class=\"doc\">表示形式のローカライズ</span></a> が優先されます。たとえば <code class=\"docutils literal notranslate\"><span class=\"pre\">'de'</span></code>  (ドイツ語) では次のようになります。</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">45000</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">'45.000'</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">450000</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">'450.000'</span></code> になります。</p></li>\n</ul>\n</section>\n<section id=\"intword\">\n<span id=\"std-templatefilter-intword\"></span><h2><code class=\"docutils literal notranslate\"><span class=\"pre\">intword</span></code><a class=\"heading-anchor\" href=\"#intword\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>大きな整数 (または整数の文字列表現) をわかりやすいテキスト表現に変換します。<code class=\"docutils literal notranslate\"><span class=\"pre\">1.0</span></code> を単数のフレーズとして翻訳し、その他のすべての数値を複数形として扱います。これは一部の言語にとって正しくない場合があります。100 万を超える数値に最適です。</p>\n<p>例:</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">1000000</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">1.0</span> <span class=\"pre\">million</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">1200000</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">1.2</span> <span class=\"pre\">million</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">1200000000</span></code> は  <code class=\"docutils literal notranslate\"><span class=\"pre\">1.2</span> <span class=\"pre\">billion</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">-1200000000</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">-1.2</span> <span class=\"pre\">billion</span></code> になります。</p></li>\n</ul>\n<p>値は 10^100 (Googol) までサポートされます。</p>\n<p>可能であれば <a class=\"reference internal\" href=\"/ja/5.1/topics/i18n/formatting/\"><span class=\"doc\">表示形式のローカライズ</span></a> が優先されます。たとえば <code class=\"docutils literal notranslate\"><span class=\"pre\">'de'</span></code>  (ドイツ語) では次のようになります。</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">1000000</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">'1,0</span> <span class=\"pre\">Million'</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">1200000</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">'1,2</span> <span class=\"pre\">Millionen'</span></code> となります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">1200000000</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">'1,2</span> <span class=\"pre\">Milliarden'</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">-1200000000</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">'-1,2</span> <span class=\"pre\">Milliarden'</span></code> になります。</p></li>\n</ul>\n</section>\n<section id=\"naturalday\">\n<span id=\"std-templatefilter-naturalday\"></span><h2><code class=\"docutils literal notranslate\"><span class=\"pre\">naturalday</span></code><a class=\"heading-anchor\" href=\"#naturalday\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>日付が今日、明日、昨日のいずれかに該当する場合、それぞれ「今日（“today”）」、 「明日（“tomorrow”）」、「昨日（“yesterday”）」を返します。それ以外の日付の 場合は、引数に渡したフォーマット文字列を使って日付をフォーマットします。</p>\n<p><strong>引数:</strong>  <a class=\"reference internal\" href=\"/ja/5.1/ref/templates/builtins/#std-templatefilter-date\"><code class=\"xref std std-tfilter docutils literal notranslate\"><span class=\"pre\">date</span></code></a> タグと同じ記法による日付フォーマット文字列</p>\n<p>表示例 ( 今日の日付を <code class=\"docutils literal notranslate\"><span class=\"pre\">2007年</span> <span class=\"pre\">2月</span> <span class=\"pre\">17日</span></code> とします ) :</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">2007年</span> <span class=\"pre\">2月</span> <span class=\"pre\">16日</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">yesterday</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">2007年</span> <span class=\"pre\">2月</span> <span class=\"pre\">17日</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">today</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">2007年</span> <span class=\"pre\">2月</span> <span class=\"pre\">18日</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">tomorrow</span></code> になります。</p></li>\n<li><p>今日、昨日、明日以外の日付は与えられた引数に従ってフォーマットされます。引数がない場合は <a class=\"reference internal\" href=\"/ja/5.1/ref/settings/#std-setting-DATE_FORMAT\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">DATE_FORMAT</span></code></a> 設定に従います。</p></li>\n</ul>\n</section>\n<section id=\"naturaltime\">\n<span id=\"std-templatefilter-naturaltime\"></span><h2><code class=\"docutils literal notranslate\"><span class=\"pre\">naturaltime</span></code><a class=\"heading-anchor\" href=\"#naturaltime\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>datetime 値に対して、何時間（分、秒）前であったかを表わす文字列を返します。1日以上前である場合は <a class=\"reference internal\" href=\"/ja/5.1/ref/templates/builtins/#std-templatefilter-timesince\"><code class=\"xref std std-tfilter docutils literal notranslate\"><span class=\"pre\">timesince</span></code></a> フォーマットにフォールバックします。 datetime 値が未来である場合も、自動的に適切なフレーズが返り値に使用されます。</p>\n<p>表示例 ( 現在の日時を <code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:30:00</span></code> とします ) :</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:30:00</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">now</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:29:31</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">29</span> <span class=\"pre\">seconds</span> <span class=\"pre\">ago</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:29:00</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">a</span> <span class=\"pre\">minute</span> <span class=\"pre\">ago</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:25:35</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">4</span> <span class=\"pre\">minutes</span> <span class=\"pre\">ago</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">15:30:29</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">59</span> <span class=\"pre\">minutes</span> <span class=\"pre\">ago</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">15:30:01</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">59</span> <span class=\"pre\">minutes</span> <span class=\"pre\">ago</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">15:30:00</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">an</span> <span class=\"pre\">hour</span> <span class=\"pre\">ago</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">13:31:29</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">2</span> <span class=\"pre\">hours</span> <span class=\"pre\">ago</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">16</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">13:31:29</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">1</span> <span class=\"pre\">day,</span> <span class=\"pre\">2</span> <span class=\"pre\">hours</span> <span class=\"pre\">ago</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">16</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">13:30:01</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">1</span> <span class=\"pre\">day,</span> <span class=\"pre\">2</span> <span class=\"pre\">hours</span> <span class=\"pre\">ago</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">16</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">13:30:00</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">1</span> <span class=\"pre\">day,</span> <span class=\"pre\">3</span> <span class=\"pre\">hours</span> <span class=\"pre\">ago</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:30:30</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">30</span> <span class=\"pre\">seconds</span> <span class=\"pre\">from</span> <span class=\"pre\">now</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:30:29</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">29</span> <span class=\"pre\">seconds</span> <span class=\"pre\">from</span> <span class=\"pre\">now</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:31:00</span></code> becomes <code class=\"docutils literal notranslate\"><span class=\"pre\">a</span> <span class=\"pre\">minute</span> <span class=\"pre\">from</span> <span class=\"pre\">now</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:34:35</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">4</span> <span class=\"pre\">minutes</span> <span class=\"pre\">from</span> <span class=\"pre\">now</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">17:30:29</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">an</span> <span class=\"pre\">hour</span> <span class=\"pre\">from</span> <span class=\"pre\">now</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">18:31:29</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">2</span> <span class=\"pre\">hours</span> <span class=\"pre\">from</span> <span class=\"pre\">now</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">18</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:31:29</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">1</span> <span class=\"pre\">day</span> <span class=\"pre\">from</span> <span class=\"pre\">now</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">26</span> <span class=\"pre\">Feb</span> <span class=\"pre\">2007</span> <span class=\"pre\">18:31:29</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">1</span> <span class=\"pre\">week,</span> <span class=\"pre\">2</span> <span class=\"pre\">days</span> <span class=\"pre\">from</span> <span class=\"pre\">now</span></code> になります。</p></li>\n</ul>\n</section>\n<section id=\"ordinal\">\n<span id=\"std-templatefilter-ordinal\"></span><h2><code class=\"docutils literal notranslate\"><span class=\"pre\">ordinal</span></code><a class=\"heading-anchor\" href=\"#ordinal\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>整数を序数形式の文字列に変換します。</p>\n<p>例:</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">1</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">1st</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">2</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">2nd</span></code> になります。</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">3</span></code> は <code class=\"docutils literal notranslate\"><span class=\"pre\">3rd</span></code> になります。</p></li>\n</ul>\n<p>整数または整数の文字列表現を渡すことができます。負の整数はそのまま返されます。</p>\n</section>","rootId":"module-django.contrib.humanize","toc":[{"title":"apnumber","anchor":"apnumber","children":[]},{"title":"intcomma","anchor":"intcomma","children":[]},{"title":"intword","anchor":"intword","children":[]},{"title":"naturalday","anchor":"naturalday","children":[]},{"title":"naturaltime","anchor":"naturaltime","children":[]},{"title":"ordinal","anchor":"ordinal","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"API リファレンス","url":"/ja/5.1/ref/"},{"docname":"ref/contrib/index","title":"contrib パッケージ","url":"/ja/5.1/ref/contrib/"}],"prev":{"docname":"ref/contrib/gis/deployment","title":"GeoDjango のデプロイ","url":"/ja/5.1/ref/contrib/gis/deployment/"},"next":{"docname":"ref/contrib/messages","title":"メッセージフレームワーク","url":"/ja/5.1/ref/contrib/messages/"},"formats":{"html":"/ja/5.1/ref/contrib/humanize/","markdown":"/ja/5.1/ref/contrib/humanize.md","json":"/ja/5.1/ref/contrib/humanize.json"},"source":"https://github.com/django/django/blob/stable/5.1.x/docs/ref/contrib/humanize.txt","official":"https://docs.djangoproject.com/ja/5.1/ref/contrib/humanize/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}