{"title":"PostgreSQL 特有数据库函数","version":"6.1","locale":"zh-hans","docname":"ref/contrib/postgres/functions","url":"/zh-hans/6.1/ref/contrib/postgres/functions/","canonical":"https://djangodocs.dev/zh-hans/6.1/ref/contrib/postgres/functions/","summary":"所有这些函数都可以从 django.contrib.postgres.function 模块中获得。返回一个版本 4 的 UUID。","html":"<h1>PostgreSQL 特有数据库函数<a class=\"heading-anchor\" href=\"#postgresql-specific-database-functions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>所有这些函数都可以从 <code class=\"docutils literal notranslate\">django.contrib.postgres.function</code> 模块中获得。</p>\n<section id=\"randomuuid\">\n<h2><code class=\"docutils literal notranslate\">RandomUUID</code><a class=\"heading-anchor\" href=\"#randomuuid\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.functions.RandomUUID\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">RandomUUID</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.functions.RandomUUID\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>返回一个版本 4 的 UUID。</p>\n<p>用法示例：</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span><span class=\"kn\">from</span> <span class=\"nn\">django.contrib.postgres.functions</span> <span class=\"kn\">import</span> RandomUUID\n<span class=\"gp\">&gt;&gt;&gt; </span>Article<span class=\"o\">.</span>objects<span class=\"o\">.</span>update<span class=\"p\">(</span>uuid<span class=\"o\">=</span>RandomUUID<span class=\"p\">())</span>\n</code></pre></div>\n<aside class=\"admonition-use-class-django-db-models-functions-uuid4-instead admonition\" role=\"note\">\n<p class=\"admonition-title\">Use <a class=\"reference internal\" href=\"/zh-hans/6.1/ref/models/database-functions/#django.db.models.functions.UUID4\" title=\"django.db.models.functions.UUID4\"><code class=\"xref py py-class docutils literal notranslate\">django.db.models.functions.UUID4</code></a> instead.</p>\n<p><a class=\"reference internal\" href=\"/zh-hans/6.1/ref/models/database-functions/#django.db.models.functions.UUID4\" title=\"django.db.models.functions.UUID4\"><code class=\"xref py py-class docutils literal notranslate\">django.db.models.functions.UUID4</code></a> is a cross-database version of\nthis function. <code class=\"docutils literal notranslate\">RandomUUID</code> may be deprecated in the future.</p>\n</aside>\n</section>\n<section id=\"transactionnow\">\n<h2><code class=\"docutils literal notranslate\">TransactionNow</code><a class=\"heading-anchor\" href=\"#transactionnow\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.functions.TransactionNow\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">TransactionNow</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.functions.TransactionNow\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>返回数据库服务器上当前事务开始的日期和时间。如果你不在事务中，它将返回当前语句的日期和时间。这是对 <code class=\"xref py py-class docutils literal notranslate\">django.db.models.function.Now</code> 的补充，后者返回当前语句的日期和时间。</p>\n<p>Note that only the outermost call to <a class=\"reference internal\" href=\"/zh-hans/6.1/topics/db/transactions/#django.db.transaction.atomic\" title=\"django.db.transaction.atomic\"><code class=\"xref py py-func docutils literal notranslate\">atomic()</code></a>\nsets up a transaction and thus sets the time that <code class=\"docutils literal notranslate\">TransactionNow()</code> will\nreturn; nested calls create savepoints which do not affect the transaction\ntime.</p>\n<p>用法示例：</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span><span class=\"kn\">from</span> <span class=\"nn\">django.contrib.postgres.functions</span> <span class=\"kn\">import</span> TransactionNow\n<span class=\"gp\">&gt;&gt;&gt; </span>Article<span class=\"o\">.</span>objects<span class=\"o\">.</span>filter<span class=\"p\">(</span>published__lte<span class=\"o\">=</span>TransactionNow<span class=\"p\">())</span>\n<span class=\"go\">&lt;QuerySet [&lt;Article: How to Django&gt;]&gt;</span>\n</code></pre></div>\n</section>","rootId":"postgresql-specific-database-functions","toc":[{"title":"RandomUUID","anchor":"randomuuid","children":[]},{"title":"TransactionNow","anchor":"transactionnow","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"API 参考","url":"/zh-hans/6.1/ref/"},{"docname":"ref/contrib/index","title":"contrib 包","url":"/zh-hans/6.1/ref/contrib/"},{"docname":"ref/contrib/postgres/index","title":"django.contrib.postgres","url":"/zh-hans/6.1/ref/contrib/postgres/"}],"prev":{"docname":"ref/contrib/postgres/forms","title":"PostgreSQL 特有表单字段和部件","url":"/zh-hans/6.1/ref/contrib/postgres/forms/"},"next":{"docname":"ref/contrib/postgres/indexes","title":"PostgreSQL 特有模型索引","url":"/zh-hans/6.1/ref/contrib/postgres/indexes/"},"formats":{"html":"/zh-hans/6.1/ref/contrib/postgres/functions/","markdown":"/zh-hans/6.1/ref/contrib/postgres/functions.md","json":"/zh-hans/6.1/ref/contrib/postgres/functions.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/ref/contrib/postgres/functions.txt","official":"https://docs.djangoproject.com/zh-hans/6.1/ref/contrib/postgres/functions/","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"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}