型のヒントで「null可能」な戻り値の型を指定する方法

関数があるとしましょう：

def get_some_date(some_argument: int=None) -> %datetime_or_None%:
    if some_argument is not None and some_argument == 1:
        return datetime.utcnow()
    else:
        return None

可能な値の戻り値の型を指定するにはどうすればよいNoneですか？

あなたが探していOptionalます。

あなたの戻り値の型は、いずれかになりますのでdatetime（から返されるdatetime.utcnow()）、またはNoneあなたが使用する必要がありますOptional[datetime]：

from typing import Optional

def get_some_date(some_argument: int=None) -> Optional[datetime]:
    # as defined

入力に関するドキュメントから、Optionalは以下の略記です：

Optional[X]と同等Union[X, None]です。

where Union[X, Y]は、型Xまたはの値を意味しますY。

他の人がつまずき、そのOptional意味がわからないかもしれないという懸念のために明示的になりたい場合は、いつでも使用できますUnion。

from typing import Union

def get_some_date(some_argument: int=None) -> Union[datetime, None]:

しかし、これは良いアイデアだOptionalとは思いませんが、目立つ名前であり、キーストロークをいくつか節約できます。

_{Michael0x2aは@でコメントで指摘したようUnion[T, None]にtranformedされるUnion[T, type(None)]必要は使用しないようにしてtypeここに。}

視覚的にはこれらは異なる場合がありますが、プログラム的には、どちらの場合も結果はまったく同じです。^*にUnion[datetime.datetime, NoneType]格納されるタイプになります。get_some_date.__annotations__

>>> from typing import get_type_hints
>>> print(get_type_hints(get_some_date))
{'return': typing.Union[datetime.datetime, NoneType],
 'some_argument': typing.Union[int, NoneType]}

^*直接アクセスするのではなくtyping.get_type_hints、オブジェクトの__annotations__属性を取得するために使用します。