Creates a Period object from an ISO 8601 string. Supports both ISO 8601-1 and ISO 8601-2 formats. You shouldn't normally need to call this method directly since Period
objects are created by the SDK. This can be useful in some cases for testing purposes.