DOCSP-44476 - BsonValue properties (#256)

(cherry picked from commit dd333de)

Author: mongoKart

source/upgrade/v3.txt

@@ -163,3 +163,15 @@ Version 3.0 Breaking Changes
   `Double.PositiveInfinity, <https://learn.microsoft.com/en-us/dotnet/api/system.double.positiveinfinity?view=net-8.0#system-double-positiveinfinity>`__
   and `Double.NegativeInfinity. <https://learn.microsoft.com/en-us/dotnet/api/system.double.negativeinfinity?view=net-8.0#system-double-negativeinfinity>`__
   on MSDN.
+
+- The driver includes the following changes to the ``BsonValue`` class:
+
+  - Removes the ``[Obsolete]`` attribute from the ``AsLocalTime`` and
+    ``AsUniversalTime`` properties.
+  - Adds the `AsNullableLocalTime <{+new-api-root+}/MongoDB.Bson/MongoDB.Bson.BsonValue.AsNullableLocalTime.html#MongoDB_Bson_BsonValue_AsNullableLocalTime>`__
+    and `AsNullableUniversalTime <{+new-api-root+}/MongoDB.Bson/MongoDB.Bson.BsonValue.AsNullableUniversalTime.html#MongoDB_Bson_BsonValue_AsNullableUniversalTime>`__
+    properties.
+  - Removes the ``AsDateTime`` property. Use the `AsUniversalTime <{+new-api-root+}/MongoDB.Bson/MongoDB.Bson.BsonValue.AsUniversalTime.html#MongoDB_Bson_BsonValue_AsUniversalTime>`__
+    property instead. 
+  - Removes the ``AsNullableDateTime`` property. Use the `AsNullableUniversalTime <{+new-api-root+}/MongoDB.Bson/MongoDB.Bson.BsonValue.AsNullableUniversalTime.html#MongoDB_Bson_BsonValue_AsNullableUniversalTime>`__
+    property instead.